swetrix 1.0.3 → 1.3.1

package/LICENSE

@@ -1,201 +1,21 @@
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   Licensed under the Apache License, Version 2.0 (the "License");
-   you may not use this file except in compliance with the License.
-   You may obtain a copy of the License at
-
-       http://www.apache.org/licenses/LICENSE-2.0
-
-   Unless required by applicable law or agreed to in writing, software
-   distributed under the License is distributed on an "AS IS" BASIS,
-   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-   See the License for the specific language governing permissions and
-   limitations under the License.
+MIT License
+
+Copyright (c) 2021 Andrii Romasiun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,5 @@
+<img src="https://swetrix.com/assets/logo_blue.svg" alt="" height="100" />
+
 # Swetrix Tracking Script
 
 This repository contains the analytics script which is used at https://swetrix.com \
@@ -5,3 +7,6 @@ You can find the detailed documentation and use cases at our [docs page](https:/
 
 Feel free to contribute to the source code by opening a pull requests. \
 For any questions, you can open an issue ticket, refer to our [FAQs](https://swetrix.com/#faq) page or reach us at contact@swetrix.com
+
+# Selfhosted API
+If you are selfhosting the [Swetrix-API](https://github.com/Swetrix/swetrix-api), be sure to point the `apiUrl` parameter to: `https://yourapiinstance.com/log`

package/dist/esnext/Lib.d.ts

@@ -2,6 +2,7 @@ export interface LibOptions {
     debug?: boolean;
     disabled?: boolean;
     respectDNT?: boolean;
+    apiURL?: string;
 }
 export interface TrackEventOptions {
     ev: string;
@@ -13,18 +14,23 @@ export interface PageData {
 }
 export interface PageViewsOptions {
     unique?: boolean;
+    ignore?: Array<any>;
+    noHeartbeat?: boolean;
+    heartbeatOnBackground?: boolean;
 }
 export declare class Lib {
     private projectID;
     private options?;
     private pageData;
+    private pageViewsOptions;
     constructor(projectID: string, options?: LibOptions | undefined);
     track(event: TrackEventOptions): void;
-    trackPageViews(options?: PageViewsOptions): object | undefined;
+    trackPageViews(options?: PageViewsOptions): void | object;
+    private heartbeat;
+    private checkIgnore;
     private trackPathChange;
     private trackPage;
     private debug;
     private canTrack;
-    private submitData;
-    private submitCustom;
+    private sendRequest;
 }

package/dist/esnext/Lib.js

@@ -1,13 +1,14 @@
 import { isInBrowser, isLocalhost, isAutomated, getLocale, getTimezone, getReferrer, getUTMCampaign, getUTMMedium, getUTMSource, getPath, } from './utils';
-const host = 'https://api.swetrix.com/log';
+const DEFAULT_API_HOST = 'https://api.swetrix.com/log';
 export class Lib {
     constructor(projectID, options) {
         this.projectID = projectID;
         this.options = options;
         this.pageData = null;
+        this.pageViewsOptions = null;
         this.trackPathChange = this.trackPathChange.bind(this);
+        this.heartbeat = this.heartbeat.bind(this);
     }
-    // Tracks a custom event
     track(event) {
         if (!this.canTrack()) {
             return;
@@ -16,9 +17,8 @@ export class Lib {
             pid: this.projectID,
             ...event,
         };
-        this.submitCustom(data);
+        this.sendRequest('custom', data);
     }
-    // Tracks page views
     trackPageViews(options) {
         if (!this.canTrack()) {
             return;
@@ -26,20 +26,49 @@ export class Lib {
         if (this.pageData) {
             return this.pageData.actions;
         }
-        let interval;
+        this.pageViewsOptions = options;
+        let hbInterval, interval;
         if (!options?.unique) {
             interval = setInterval(this.trackPathChange, 2000);
         }
+        if (!options?.noHeartbeat) {
+            setTimeout(this.heartbeat, 3000);
+            hbInterval = setInterval(this.heartbeat, 28000);
+        }
         const path = getPath();
         this.pageData = {
             path,
             actions: {
-                stop: options?.unique ? () => { } : () => clearInterval(interval),
+                stop: () => {
+                    clearInterval(interval);
+                    clearInterval(hbInterval);
+                },
             },
         };
         this.trackPage(path, options?.unique);
         return this.pageData.actions;
     }
+    heartbeat() {
+        if (!this.pageViewsOptions?.heartbeatOnBackground && document.visibilityState === 'hidden') {
+            return;
+        }
+        const data = {
+            pid: this.projectID,
+        };
+        this.sendRequest('hb', data);
+    }
+    checkIgnore(path) {
+        const ignore = this.pageViewsOptions?.ignore;
+        if (Array.isArray(ignore)) {
+            for (let i = 0; i < ignore.length; ++i) {
+                if (ignore[i] === path)
+                    return true;
+                if (ignore[i] instanceof RegExp && ignore[i].test(path))
+                    return true;
+            }
+        }
+        return false;
+    }
     // Tracking path changes. If path changes -> calling this.trackPage method
     trackPathChange() {
         if (!this.pageData)
@@ -54,6 +83,8 @@ export class Lib {
         if (!this.pageData)
             return;
         this.pageData.path = pg;
+        if (this.checkIgnore(pg))
+            return;
         const data = {
             pid: this.projectID,
             lc: getLocale(),
@@ -65,7 +96,7 @@ export class Lib {
             unique,
             pg,
         };
-        this.submitData(data);
+        this.sendRequest('', data);
     }
     debug(message) {
         if (this.options?.debug) {
@@ -73,6 +104,10 @@ export class Lib {
         }
     }
     canTrack() {
+        if (this.options?.disabled) {
+            this.debug('Tracking disabled: the \'disabled\' setting is set to true.');
+            return false;
+        }
         if (!isInBrowser()) {
             this.debug('Tracking disabled: script does not run in browser environment.');
             return false;
@@ -90,25 +125,12 @@ export class Lib {
         }
         return true;
     }
-    submitData(body) {
-        return fetch(host, {
-            method: 'post',
-            headers: {
-                'Accept': 'application/json',
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify(body),
-        });
-    }
-    submitCustom(body) {
-        return fetch(`${host}/custom`, {
-            method: 'post',
-            headers: {
-                'Accept': 'application/json',
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify(body),
-        });
+    sendRequest(path, body) {
+        const host = this.options?.apiURL || DEFAULT_API_HOST;
+        const req = new XMLHttpRequest();
+        req.open('POST', `${host}/${path}`, true);
+        req.setRequestHeader('Content-Type', 'application/json');
+        req.send(JSON.stringify(body));
     }
 }
 //# sourceMappingURL=Lib.js.map

package/dist/esnext/Lib.js.map

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

package/dist/swetrix.cjs.js

@@ -66,23 +66,23 @@ var getPath = function () {
     return location.pathname || '';
 };
 
-var host = 'https://api.swetrix.com/log';
+var DEFAULT_API_HOST = 'https://api.swetrix.com/log';
 var Lib = /** @class */ (function () {
     function Lib(projectID, options) {
         this.projectID = projectID;
         this.options = options;
         this.pageData = null;
+        this.pageViewsOptions = null;
         this.trackPathChange = this.trackPathChange.bind(this);
+        this.heartbeat = this.heartbeat.bind(this);
     }
-    // Tracks a custom event
     Lib.prototype.track = function (event) {
         if (!this.canTrack()) {
             return;
         }
         var data = __assign({ pid: this.projectID }, event);
-        this.submitCustom(data);
+        this.sendRequest('custom', data);
     };
-    // Tracks page views
     Lib.prototype.trackPageViews = function (options) {
         if (!this.canTrack()) {
             return;
@@ -90,20 +90,51 @@ var Lib = /** @class */ (function () {
         if (this.pageData) {
             return this.pageData.actions;
         }
-        var interval;
+        this.pageViewsOptions = options;
+        var hbInterval, interval;
         if (!(options === null || options === void 0 ? void 0 : options.unique)) {
             interval = setInterval(this.trackPathChange, 2000);
         }
+        if (!(options === null || options === void 0 ? void 0 : options.noHeartbeat)) {
+            setTimeout(this.heartbeat, 3000);
+            hbInterval = setInterval(this.heartbeat, 28000);
+        }
         var path = getPath();
         this.pageData = {
             path: path,
             actions: {
-                stop: (options === null || options === void 0 ? void 0 : options.unique) ? function () { } : function () { return clearInterval(interval); },
+                stop: function () {
+                    clearInterval(interval);
+                    clearInterval(hbInterval);
+                },
             },
         };
         this.trackPage(path, options === null || options === void 0 ? void 0 : options.unique);
         return this.pageData.actions;
     };
+    Lib.prototype.heartbeat = function () {
+        var _a;
+        if (!((_a = this.pageViewsOptions) === null || _a === void 0 ? void 0 : _a.heartbeatOnBackground) && document.visibilityState === 'hidden') {
+            return;
+        }
+        var data = {
+            pid: this.projectID,
+        };
+        this.sendRequest('hb', data);
+    };
+    Lib.prototype.checkIgnore = function (path) {
+        var _a;
+        var ignore = (_a = this.pageViewsOptions) === null || _a === void 0 ? void 0 : _a.ignore;
+        if (Array.isArray(ignore)) {
+            for (var i = 0; i < ignore.length; ++i) {
+                if (ignore[i] === path)
+                    return true;
+                if (ignore[i] instanceof RegExp && ignore[i].test(path))
+                    return true;
+            }
+        }
+        return false;
+    };
     // Tracking path changes. If path changes -> calling this.trackPage method
     Lib.prototype.trackPathChange = function () {
         if (!this.pageData)
@@ -119,6 +150,8 @@ var Lib = /** @class */ (function () {
         if (!this.pageData)
             return;
         this.pageData.path = pg;
+        if (this.checkIgnore(pg))
+            return;
         var data = {
             pid: this.projectID,
             lc: getLocale(),
@@ -130,7 +163,7 @@ var Lib = /** @class */ (function () {
             unique: unique,
             pg: pg,
         };
-        this.submitData(data);
+        this.sendRequest('', data);
     };
     Lib.prototype.debug = function (message) {
         var _a;
@@ -139,16 +172,20 @@ var Lib = /** @class */ (function () {
         }
     };
     Lib.prototype.canTrack = function () {
-        var _a, _b, _c;
+        var _a, _b, _c, _d;
+        if ((_a = this.options) === null || _a === void 0 ? void 0 : _a.disabled) {
+            this.debug('Tracking disabled: the \'disabled\' setting is set to true.');
+            return false;
+        }
         if (!isInBrowser()) {
             this.debug('Tracking disabled: script does not run in browser environment.');
             return false;
         }
-        if (((_a = this.options) === null || _a === void 0 ? void 0 : _a.respectDNT) && ((_b = window.navigator) === null || _b === void 0 ? void 0 : _b.doNotTrack) === '1') {
+        if (((_b = this.options) === null || _b === void 0 ? void 0 : _b.respectDNT) && ((_c = window.navigator) === null || _c === void 0 ? void 0 : _c.doNotTrack) === '1') {
             this.debug('Tracking disabled: respecting user\'s \'Do Not Track\' preference.');
             return false;
         }
-        if (!((_c = this.options) === null || _c === void 0 ? void 0 : _c.debug) && isLocalhost()) {
+        if (!((_d = this.options) === null || _d === void 0 ? void 0 : _d.debug) && isLocalhost()) {
             return false;
         }
         if (isAutomated()) {
@@ -157,25 +194,13 @@ var Lib = /** @class */ (function () {
         }
         return true;
     };
-    Lib.prototype.submitData = function (body) {
-        return fetch(host, {
-            method: 'post',
-            headers: {
-                'Accept': 'application/json',
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify(body),
-        });
-    };
-    Lib.prototype.submitCustom = function (body) {
-        return fetch(host + "/custom", {
-            method: 'post',
-            headers: {
-                'Accept': 'application/json',
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify(body),
-        });
+    Lib.prototype.sendRequest = function (path, body) {
+        var _a;
+        var host = ((_a = this.options) === null || _a === void 0 ? void 0 : _a.apiURL) || DEFAULT_API_HOST;
+        var req = new XMLHttpRequest();
+        req.open('POST', "".concat(host, "/").concat(path), true);
+        req.setRequestHeader('Content-Type', 'application/json');
+        req.send(JSON.stringify(body));
     };
     return Lib;
 }());

package/dist/swetrix.es5.js

@@ -62,23 +62,23 @@ var getPath = function () {
     return location.pathname || '';
 };
 
-var host = 'https://api.swetrix.com/log';
+var DEFAULT_API_HOST = 'https://api.swetrix.com/log';
 var Lib = /** @class */ (function () {
     function Lib(projectID, options) {
         this.projectID = projectID;
         this.options = options;
         this.pageData = null;
+        this.pageViewsOptions = null;
         this.trackPathChange = this.trackPathChange.bind(this);
+        this.heartbeat = this.heartbeat.bind(this);
     }
-    // Tracks a custom event
     Lib.prototype.track = function (event) {
         if (!this.canTrack()) {
             return;
         }
         var data = __assign({ pid: this.projectID }, event);
-        this.submitCustom(data);
+        this.sendRequest('custom', data);
     };
-    // Tracks page views
     Lib.prototype.trackPageViews = function (options) {
         if (!this.canTrack()) {
             return;
@@ -86,20 +86,51 @@ var Lib = /** @class */ (function () {
         if (this.pageData) {
             return this.pageData.actions;
         }
-        var interval;
+        this.pageViewsOptions = options;
+        var hbInterval, interval;
         if (!(options === null || options === void 0 ? void 0 : options.unique)) {
             interval = setInterval(this.trackPathChange, 2000);
         }
+        if (!(options === null || options === void 0 ? void 0 : options.noHeartbeat)) {
+            setTimeout(this.heartbeat, 3000);
+            hbInterval = setInterval(this.heartbeat, 28000);
+        }
         var path = getPath();
         this.pageData = {
             path: path,
             actions: {
-                stop: (options === null || options === void 0 ? void 0 : options.unique) ? function () { } : function () { return clearInterval(interval); },
+                stop: function () {
+                    clearInterval(interval);
+                    clearInterval(hbInterval);
+                },
             },
         };
         this.trackPage(path, options === null || options === void 0 ? void 0 : options.unique);
         return this.pageData.actions;
     };
+    Lib.prototype.heartbeat = function () {
+        var _a;
+        if (!((_a = this.pageViewsOptions) === null || _a === void 0 ? void 0 : _a.heartbeatOnBackground) && document.visibilityState === 'hidden') {
+            return;
+        }
+        var data = {
+            pid: this.projectID,
+        };
+        this.sendRequest('hb', data);
+    };
+    Lib.prototype.checkIgnore = function (path) {
+        var _a;
+        var ignore = (_a = this.pageViewsOptions) === null || _a === void 0 ? void 0 : _a.ignore;
+        if (Array.isArray(ignore)) {
+            for (var i = 0; i < ignore.length; ++i) {
+                if (ignore[i] === path)
+                    return true;
+                if (ignore[i] instanceof RegExp && ignore[i].test(path))
+                    return true;
+            }
+        }
+        return false;
+    };
     // Tracking path changes. If path changes -> calling this.trackPage method
     Lib.prototype.trackPathChange = function () {
         if (!this.pageData)
@@ -115,6 +146,8 @@ var Lib = /** @class */ (function () {
         if (!this.pageData)
             return;
         this.pageData.path = pg;
+        if (this.checkIgnore(pg))
+            return;
         var data = {
             pid: this.projectID,
             lc: getLocale(),
@@ -126,7 +159,7 @@ var Lib = /** @class */ (function () {
             unique: unique,
             pg: pg,
         };
-        this.submitData(data);
+        this.sendRequest('', data);
     };
     Lib.prototype.debug = function (message) {
         var _a;
@@ -135,16 +168,20 @@ var Lib = /** @class */ (function () {
         }
     };
     Lib.prototype.canTrack = function () {
-        var _a, _b, _c;
+        var _a, _b, _c, _d;
+        if ((_a = this.options) === null || _a === void 0 ? void 0 : _a.disabled) {
+            this.debug('Tracking disabled: the \'disabled\' setting is set to true.');
+            return false;
+        }
         if (!isInBrowser()) {
             this.debug('Tracking disabled: script does not run in browser environment.');
             return false;
         }
-        if (((_a = this.options) === null || _a === void 0 ? void 0 : _a.respectDNT) && ((_b = window.navigator) === null || _b === void 0 ? void 0 : _b.doNotTrack) === '1') {
+        if (((_b = this.options) === null || _b === void 0 ? void 0 : _b.respectDNT) && ((_c = window.navigator) === null || _c === void 0 ? void 0 : _c.doNotTrack) === '1') {
             this.debug('Tracking disabled: respecting user\'s \'Do Not Track\' preference.');
             return false;
         }
-        if (!((_c = this.options) === null || _c === void 0 ? void 0 : _c.debug) && isLocalhost()) {
+        if (!((_d = this.options) === null || _d === void 0 ? void 0 : _d.debug) && isLocalhost()) {
             return false;
         }
         if (isAutomated()) {
@@ -153,25 +190,13 @@ var Lib = /** @class */ (function () {
         }
         return true;
     };
-    Lib.prototype.submitData = function (body) {
-        return fetch(host, {
-            method: 'post',
-            headers: {
-                'Accept': 'application/json',
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify(body),
-        });
-    };
-    Lib.prototype.submitCustom = function (body) {
-        return fetch(host + "/custom", {
-            method: 'post',
-            headers: {
-                'Accept': 'application/json',
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify(body),
-        });
+    Lib.prototype.sendRequest = function (path, body) {
+        var _a;
+        var host = ((_a = this.options) === null || _a === void 0 ? void 0 : _a.apiURL) || DEFAULT_API_HOST;
+        var req = new XMLHttpRequest();
+        req.open('POST', "".concat(host, "/").concat(path), true);
+        req.setRequestHeader('Content-Type', 'application/json');
+        req.send(JSON.stringify(body));
     };
     return Lib;
 }());

package/dist/swetrix.js

@@ -1 +1 @@
-!function(t,n){"object"==typeof exports&&"undefined"!=typeof module?n(exports):"function"==typeof define&&define.amd?define(["exports"],n):n((t="undefined"!=typeof globalThis?globalThis:t||self).swetrix={})}(this,function(o){"use strict";function i(t){return(t=location.search.match(t))&&t[2]||void 0}function e(){return location.pathname||""}var n=function(){return(n=Object.assign||function(t){for(var n,o=1,i=arguments.length;o<i;o++)for(var e in n=arguments[o])Object.prototype.hasOwnProperty.call(n,e)&&(t[e]=n[e]);return t}).apply(this,arguments)},a=/[?&](ref|source|utm_source)=([^?&]+)/,r=/[?&](utm_campaign)=([^?&]+)/,s=/[?&](utm_medium)=([^?&]+)/,c="https://api.swetrix.com/log",u=(t.prototype.track=function(t){this.canTrack()&&(t=n({pid:this.projectID},t),this.submitCustom(t))},t.prototype.trackPageViews=function(t){if(this.canTrack()){if(this.pageData)return this.pageData.actions;var n;null!=t&&t.unique||(n=setInterval(this.trackPathChange,2e3));var o=e();return this.pageData={path:o,actions:{stop:null!=t&&t.unique?function(){}:function(){return clearInterval(n)}}},this.trackPage(o,null==t?void 0:t.unique),this.pageData.actions}},t.prototype.trackPathChange=function(){var t;this.pageData&&(t=e(),this.pageData.path!==t&&this.trackPage(t,!1))},t.prototype.trackPage=function(t,n){void 0===n&&(n=!1),this.pageData&&(this.pageData.path=t,t={pid:this.projectID,lc:void 0!==navigator.languages?navigator.languages[0]:navigator.language,tz:function(){try{return Intl.DateTimeFormat().resolvedOptions().timeZone}catch(t){return}}(),ref:document.referrer||void 0,so:i(a),me:i(s),ca:i(r),unique:n,pg:t},this.submitData(t))},t.prototype.debug=function(t){var n;null!==(n=this.options)&&void 0!==n&&n.debug&&console.log("[Swetrix]",t)},t.prototype.canTrack=function(){var t,n;return"undefined"==typeof window?(this.debug("Tracking disabled: script does not run in browser environment."),!1):null!==(t=this.options)&&void 0!==t&&t.respectDNT&&"1"===(null===(n=window.navigator)||void 0===n?void 0:n.doNotTrack)?(this.debug("Tracking disabled: respecting user's 'Do Not Track' preference."),!1):!!(null!==(n=this.options)&&void 0!==n&&n.debug||"localhost"!==(null===location||void 0===location?void 0:location.hostname)&&"127.0.0.1"!==(null===location||void 0===location?void 0:location.hostname)&&""!==(null===location||void 0===location?void 0:location.hostname))&&(null===navigator||void 0===navigator||!navigator.webdriver||(this.debug("Tracking disabled: navigation is automated by WebDriver."),!1))},t.prototype.submitData=function(t){return fetch(c,{method:"post",headers:{Accept:"application/json","Content-Type":"application/json"},body:JSON.stringify(t)})},t.prototype.submitCustom=function(t){return fetch(c+"/custom",{method:"post",headers:{Accept:"application/json","Content-Type":"application/json"},body:JSON.stringify(t)})},t);function t(t,n){this.projectID=t,this.options=n,this.pageData=null,this.trackPathChange=this.trackPathChange.bind(this)}o.LIB_INSTANCE=null,o.init=function(t,n){return o.LIB_INSTANCE||(o.LIB_INSTANCE=new u(t,n)),o.LIB_INSTANCE},o.track=function(t){o.LIB_INSTANCE&&o.LIB_INSTANCE.track(t)},o.trackViews=function(t){o.LIB_INSTANCE&&o.LIB_INSTANCE.trackPageViews(t)},Object.defineProperty(o,"__esModule",{value:!0})});
+!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?e(exports):"function"==typeof define&&define.amd?define(["exports"],e):e((t="undefined"!=typeof globalThis?globalThis:t||self).swetrix={})}(this,function(i){"use strict";function n(t){return(t=location.search.match(t))&&t[2]||void 0}function a(){return location.pathname||""}var e=function(){return(e=Object.assign||function(t){for(var e,i=1,n=arguments.length;i<n;i++)for(var a in e=arguments[i])Object.prototype.hasOwnProperty.call(e,a)&&(t[a]=e[a]);return t}).apply(this,arguments)},o=/[?&](ref|source|utm_source)=([^?&]+)/,r=/[?&](utm_campaign)=([^?&]+)/,s=/[?&](utm_medium)=([^?&]+)/,c=(t.prototype.track=function(t){this.canTrack()&&(t=e({pid:this.projectID},t),this.sendRequest("custom",t))},t.prototype.trackPageViews=function(t){if(this.canTrack()){if(this.pageData)return this.pageData.actions;var e,i;null!=(this.pageViewsOptions=t)&&t.unique||(i=setInterval(this.trackPathChange,2e3)),null!=t&&t.noHeartbeat||(setTimeout(this.heartbeat,3e3),e=setInterval(this.heartbeat,28e3));var n=a();return this.pageData={path:n,actions:{stop:function(){clearInterval(i),clearInterval(e)}}},this.trackPage(n,null==t?void 0:t.unique),this.pageData.actions}},t.prototype.heartbeat=function(){var t;(null!==(t=this.pageViewsOptions)&&void 0!==t&&t.heartbeatOnBackground||"hidden"!==document.visibilityState)&&(t={pid:this.projectID},this.sendRequest("hb",t))},t.prototype.checkIgnore=function(t){var e,i=null===(e=this.pageViewsOptions)||void 0===e?void 0:e.ignore;if(Array.isArray(i))for(var n=0;n<i.length;++n){if(i[n]===t)return!0;if(i[n]instanceof RegExp&&i[n].test(t))return!0}return!1},t.prototype.trackPathChange=function(){var t;this.pageData&&(t=a(),this.pageData.path!==t&&this.trackPage(t,!1))},t.prototype.trackPage=function(t,e){void 0===e&&(e=!1),this.pageData&&(this.pageData.path=t,this.checkIgnore(t)||(t={pid:this.projectID,lc:void 0!==navigator.languages?navigator.languages[0]:navigator.language,tz:function(){try{return Intl.DateTimeFormat().resolvedOptions().timeZone}catch(t){return}}(),ref:document.referrer||void 0,so:n(o),me:n(s),ca:n(r),unique:e,pg:t},this.sendRequest("",t)))},t.prototype.debug=function(t){var e;null!==(e=this.options)&&void 0!==e&&e.debug&&console.log("[Swetrix]",t)},t.prototype.canTrack=function(){var t,e;return null!==(t=this.options)&&void 0!==t&&t.disabled?(this.debug("Tracking disabled: the 'disabled' setting is set to true."),!1):"undefined"==typeof window?(this.debug("Tracking disabled: script does not run in browser environment."),!1):null!==(t=this.options)&&void 0!==t&&t.respectDNT&&"1"===(null===(e=window.navigator)||void 0===e?void 0:e.doNotTrack)?(this.debug("Tracking disabled: respecting user's 'Do Not Track' preference."),!1):!!(null!==(e=this.options)&&void 0!==e&&e.debug||"localhost"!==(null===location||void 0===location?void 0:location.hostname)&&"127.0.0.1"!==(null===location||void 0===location?void 0:location.hostname)&&""!==(null===location||void 0===location?void 0:location.hostname))&&(null===navigator||void 0===navigator||!navigator.webdriver||(this.debug("Tracking disabled: navigation is automated by WebDriver."),!1))},t.prototype.sendRequest=function(t,e){var i=(null===(n=this.options)||void 0===n?void 0:n.apiURL)||"https://api.swetrix.com/log",n=new XMLHttpRequest;n.open("POST","".concat(i,"/").concat(t),!0),n.setRequestHeader("Content-Type","application/json"),n.send(JSON.stringify(e))},t);function t(t,e){this.projectID=t,this.options=e,this.pageData=null,this.pageViewsOptions=null,this.trackPathChange=this.trackPathChange.bind(this),this.heartbeat=this.heartbeat.bind(this)}i.LIB_INSTANCE=null,i.init=function(t,e){return i.LIB_INSTANCE||(i.LIB_INSTANCE=new c(t,e)),i.LIB_INSTANCE},i.track=function(t){i.LIB_INSTANCE&&i.LIB_INSTANCE.track(t)},i.trackViews=function(t){i.LIB_INSTANCE&&i.LIB_INSTANCE.trackPageViews(t)},Object.defineProperty(i,"__esModule",{value:!0})});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "swetrix",
-  "version": "1.0.3",
+  "version": "1.3.1",
   "description": "The JavaScript analytics client for Swetrix Analytics",
   "main": "dist/swetrix.cjs.js",
   "module": "dist/swetrix.es5.js",
@@ -18,24 +18,24 @@
     "type": "git",
     "url": "git+https://github.com/Swetrix/swetrix-js.git"
   },
-  "author": "Swetrix <contact@swetrix.com>",
-  "license": "Apache-2.0",
+  "author": "Andrii R. <contact@swetrix.com>",
+  "license": "MIT",
   "bugs": {
     "url": "https://github.com/Swetrix/swetrix-js/issues"
   },
   "homepage": "https://swetrix.com/docs",
   "dependencies": {
-    "@types/node": "^14.14.41"
+    "@types/node": "^14.18.0"
   },
   "devDependencies": {
+    "@rollup/plugin-commonjs": "^21.0.1",
+    "@rollup/plugin-node-resolve": "^13.0.6",
     "rimraf": "^3.0.2",
-    "rollup": "^2.53.0",
-    "rollup-plugin-commonjs": "^10.1.0",
-    "rollup-plugin-json": "^4.0.0",
+    "rollup": "^2.61.1",
     "rollup-plugin-node-resolve": "^5.2.0",
     "rollup-plugin-sourcemaps": "^0.6.3",
     "rollup-plugin-typescript2": "^0.30.0",
     "rollup-plugin-uglify": "^6.0.4",
-    "typescript": "^4.3.5"
+    "typescript": "^4.5.3"
   }
 }

package/rollup.config.js

@@ -1,5 +1,5 @@
-import resolve from 'rollup-plugin-node-resolve'
-import commonjs from 'rollup-plugin-commonjs'
+import { nodeResolve } from '@rollup/plugin-node-resolve'
+import commonjs from '@rollup/plugin-commonjs'
 import sourceMaps from 'rollup-plugin-sourcemaps'
 import typescript from 'rollup-plugin-typescript2'
 import { uglify } from 'rollup-plugin-uglify'
@@ -13,7 +13,7 @@ export default [
       { file: pkg.module, format: 'es' },
     ],
     plugins: [
-      typescript(), resolve(), commonjs(), sourceMaps(),
+      typescript(), nodeResolve(), commonjs(), sourceMaps(),
     ]
   },
   {
@@ -22,7 +22,7 @@ export default [
       { file: pkg.browser, format: 'umd', name: 'swetrix' },
     ],
     plugins: [
-      typescript(), resolve(), commonjs(), uglify(),
+      typescript(), nodeResolve(), commonjs(), uglify(),
     ]
   }
 ]

package/src/Lib.ts

@@ -15,6 +15,9 @@ export interface LibOptions {
   // By setting this flag to `true`, we will not collect ANY kind of data about the user
   // with the DNT setting.
   respectDNT?: boolean
+
+  // Set a custom URL of the API server (for selfhosted variants of Swetrix)
+  apiURL?: string
 }
 
 export interface TrackEventOptions {
@@ -37,19 +40,29 @@ export interface PageViewsOptions {
   // If true, only unique events will be saved
   // This param is useful when tracking single-page landing websites
   unique?: boolean
+
+  // A list of Regular Expressions or string pathes to ignore
+  ignore?: Array<any>
+
+  // Do not send Heartbeat requests to the server
+  noHeartbeat?: boolean
+
+  // Send Heartbeat requests when the website tab is not active in the browser
+  heartbeatOnBackground?: boolean
 }
 
-const host = 'https://api.swetrix.com/log'
+const DEFAULT_API_HOST = 'https://api.swetrix.com/log'
 
 export class Lib {
   private pageData: PageData | null = null
+  private pageViewsOptions: PageViewsOptions | null | undefined = null
 
   constructor(private projectID: string, private options?: LibOptions) {
     this.trackPathChange = this.trackPathChange.bind(this)
+    this.heartbeat = this.heartbeat.bind(this)
   }
 
-  // Tracks a custom event
-  track(event: TrackEventOptions) {
+  track(event: TrackEventOptions): void {
     if (!this.canTrack()) {
       return
     }
@@ -58,29 +71,38 @@ export class Lib {
       pid: this.projectID,
       ...event,
     }
-    this.submitCustom(data)
+    this.sendRequest('custom', data)
   }
 
-  // Tracks page views
-  trackPageViews(options?: PageViewsOptions) {
+  trackPageViews(options?: PageViewsOptions): void | object {
     if (!this.canTrack()) {
       return
     }
+
     if (this.pageData) {
       return this.pageData.actions
     }
 
-    let interval: NodeJS.Timeout
+    this.pageViewsOptions = options
+    let hbInterval: NodeJS.Timeout, interval: NodeJS.Timeout
     if (!options?.unique) {
       interval = setInterval(this.trackPathChange, 2000)
     }
 
+    if (!options?.noHeartbeat) {
+      setTimeout(this.heartbeat, 3000)
+      hbInterval = setInterval(this.heartbeat, 28000)
+    }
+
     const path = getPath()
 
     this.pageData = {
       path,
       actions: {
-        stop: options?.unique ? () => { } : () => clearInterval(interval),
+        stop: () => {
+          clearInterval(interval)
+          clearInterval(hbInterval)
+        },
       },
     }
 
@@ -88,8 +110,32 @@ export class Lib {
     return this.pageData.actions
   }
 
+  private heartbeat(): void {
+    if (!this.pageViewsOptions?.heartbeatOnBackground && document.visibilityState === 'hidden') {
+      return
+    }
+
+    const data = {
+      pid: this.projectID,
+    }
+
+    this.sendRequest('hb', data)
+  }
+
+  private checkIgnore(path: string): boolean {
+    const ignore = this.pageViewsOptions?.ignore
+
+    if (Array.isArray(ignore)) {
+      for (let i = 0; i < ignore.length; ++i) {
+        if (ignore[i] === path) return true
+        if (ignore[i] instanceof RegExp && ignore[i].test(path)) return true
+      }
+    }
+    return false
+  }
+
   // Tracking path changes. If path changes -> calling this.trackPage method
-  private trackPathChange() {
+  private trackPathChange(): void {
     if (!this.pageData) return
     const newPath = getPath()
     const { path } = this.pageData
@@ -99,10 +145,12 @@ export class Lib {
     }
   }
 
-  private trackPage(pg: string, unique: boolean = false) {
+  private trackPage(pg: string, unique: boolean = false): void {
     if (!this.pageData) return
     this.pageData.path = pg
 
+    if (this.checkIgnore(pg)) return
+
     const data = {
       pid: this.projectID,
       lc: getLocale(),
@@ -115,16 +163,21 @@ export class Lib {
       pg,
     }
 
-    this.submitData(data)
+    this.sendRequest('', data)
   }
 
-  private debug(message: string) {
+  private debug(message: string): void {
     if (this.options?.debug) {
       console.log('[Swetrix]', message)
     }
   }
 
-  private canTrack() {
+  private canTrack(): boolean {
+    if (this.options?.disabled) {
+      this.debug('Tracking disabled: the \'disabled\' setting is set to true.')
+      return false
+    }
+
     if (!isInBrowser()) {
       this.debug('Tracking disabled: script does not run in browser environment.')
       return false
@@ -147,25 +200,11 @@ export class Lib {
     return true
   }
 
-  private submitData(body: object) {
-    return fetch(host, {
-      method: 'post',
-      headers: {
-        'Accept': 'application/json',
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify(body),
-    })
-  }
-
-  private submitCustom(body: object) {
-    return fetch(`${host}/custom`, {
-      method: 'post',
-      headers: {
-        'Accept': 'application/json',
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify(body),
-    })
+  private sendRequest(path: string, body: object): void {
+    const host = this.options?.apiURL || DEFAULT_API_HOST
+    const req = new XMLHttpRequest()
+    req.open('POST', `${host}/${path}`, true)
+    req.setRequestHeader('Content-Type', 'application/json')
+    req.send(JSON.stringify(body))
   }
 }