swetrix 3.7.1 → 4.0.0

package/dist/swetrix.es5.js

@@ -1,96 +1,25 @@
-/******************************************************************************
-Copyright (c) Microsoft Corporation.
-
-Permission to use, copy, modify, and/or distribute this software for any
-purpose with or without fee is hereby granted.
-
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
-REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
-AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
-INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
-LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
-OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
-PERFORMANCE OF THIS SOFTWARE.
-***************************************************************************** */
-/* global Reflect, Promise, SuppressedError, Symbol, Iterator */
-
-
-var __assign = function() {
-    __assign = Object.assign || function __assign(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);
-};
-
-function __awaiter(thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-}
-
-function __generator(thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
-    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
-    function verb(n) { return function (v) { return step([n, v]); }; }
-    function step(op) {
-        if (f) throw new TypeError("Generator is already executing.");
-        while (g && (g = 0, op[0] && (_ = 0)), _) try {
-            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
-            if (y = 0, t) op = [op[0] & 2, t.value];
-            switch (op[0]) {
-                case 0: case 1: t = op; break;
-                case 4: _.label++; return { value: op[1], done: false };
-                case 5: _.label++; y = op[1]; op = [0]; continue;
-                case 7: op = _.ops.pop(); _.trys.pop(); continue;
-                default:
-                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
-                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
-                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
-                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
-                    if (t[2]) _.ops.pop();
-                    _.trys.pop(); continue;
-            }
-            op = body.call(thisArg, _);
-        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
-        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
-    }
-}
-
-typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
-    var e = new Error(message);
-    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
-};
-
-var findInSearch = function (exp) {
-    var res = location.search.match(exp);
+const findInSearch = (exp) => {
+    const res = location.search.match(exp);
     return (res && res[2]) || undefined;
 };
-var utmSourceRegex = /[?&](ref|source|utm_source)=([^?&]+)/;
-var utmCampaignRegex = /[?&](utm_campaign)=([^?&]+)/;
-var utmMediumRegex = /[?&](utm_medium)=([^?&]+)/;
-var utmTermRegex = /[?&](utm_term)=([^?&]+)/;
-var utmContentRegex = /[?&](utm_content)=([^?&]+)/;
-var isInBrowser = function () {
+const utmSourceRegex = /[?&](ref|source|utm_source)=([^?&]+)/;
+const utmCampaignRegex = /[?&](utm_campaign)=([^?&]+)/;
+const utmMediumRegex = /[?&](utm_medium)=([^?&]+)/;
+const utmTermRegex = /[?&](utm_term)=([^?&]+)/;
+const utmContentRegex = /[?&](utm_content)=([^?&]+)/;
+const isInBrowser = () => {
     return typeof window !== 'undefined';
 };
-var isLocalhost = function () {
+const isLocalhost = () => {
     return (location === null || location === void 0 ? void 0 : location.hostname) === 'localhost' || (location === null || location === void 0 ? void 0 : location.hostname) === '127.0.0.1' || (location === null || location === void 0 ? void 0 : location.hostname) === '';
 };
-var isAutomated = function () {
+const isAutomated = () => {
     return navigator === null || navigator === void 0 ? void 0 : navigator.webdriver;
 };
-var getLocale = function () {
+const getLocale = () => {
     return typeof navigator.languages !== 'undefined' ? navigator.languages[0] : navigator.language;
 };
-var getTimezone = function () {
+const getTimezone = () => {
     try {
         return Intl.DateTimeFormat().resolvedOptions().timeZone;
     }
@@ -98,14 +27,14 @@ var getTimezone = function () {
         return;
     }
 };
-var getReferrer = function () {
+const getReferrer = () => {
     return document.referrer || undefined;
 };
-var getUTMSource = function () { return findInSearch(utmSourceRegex); };
-var getUTMMedium = function () { return findInSearch(utmMediumRegex); };
-var getUTMCampaign = function () { return findInSearch(utmCampaignRegex); };
-var getUTMTerm = function () { return findInSearch(utmTermRegex); };
-var getUTMContent = function () { return findInSearch(utmContentRegex); };
+const getUTMSource = () => findInSearch(utmSourceRegex);
+const getUTMMedium = () => findInSearch(utmMediumRegex);
+const getUTMCampaign = () => findInSearch(utmCampaignRegex);
+const getUTMTerm = () => findInSearch(utmTermRegex);
+const getUTMContent = () => findInSearch(utmContentRegex);
 /**
  * Function used to track the current page (path) of the application.
  * Will work in cases where the path looks like:
@@ -120,27 +49,30 @@ var getUTMContent = function () { return findInSearch(utmContentRegex); };
  * @param options.search - Whether to trigger on search change.
  * @returns The path of the current page.
  */
-var getPath = function (options) {
-    var result = location.pathname || '';
+const getPath = (options) => {
+    let result = location.pathname || '';
     if (options.hash) {
-        var hashIndex = location.hash.indexOf('?');
-        var hashString = hashIndex > -1 ? location.hash.substring(0, hashIndex) : location.hash;
+        const hashIndex = location.hash.indexOf('?');
+        const hashString = hashIndex > -1 ? location.hash.substring(0, hashIndex) : location.hash;
         result += hashString;
     }
     if (options.search) {
-        var hashIndex = location.hash.indexOf('?');
-        var searchString = location.search || (hashIndex > -1 ? location.hash.substring(hashIndex) : '');
+        const hashIndex = location.hash.indexOf('?');
+        const searchString = location.search || (hashIndex > -1 ? location.hash.substring(hashIndex) : '');
         result += searchString;
     }
     return result;
 };
 
-var defaultActions = {
-    stop: function () { },
+const defaultActions = {
+    stop() { },
 };
-var DEFAULT_API_HOST = 'https://api.swetrix.com/log';
-var Lib = /** @class */ (function () {
-    function Lib(projectID, options) {
+const DEFAULT_API_HOST = 'https://api.swetrix.com/log';
+const DEFAULT_API_BASE = 'https://api.swetrix.com';
+// Default cache duration: 5 minutes
+const DEFAULT_CACHE_DURATION = 5 * 60 * 1000;
+class Lib {
+    constructor(projectID, options) {
         this.projectID = projectID;
         this.options = options;
         this.pageData = null;
@@ -149,13 +81,14 @@ var Lib = /** @class */ (function () {
         this.perfStatsCollected = false;
         this.activePage = null;
         this.errorListenerExists = false;
+        this.cachedData = null;
         this.trackPathChange = this.trackPathChange.bind(this);
         this.heartbeat = this.heartbeat.bind(this);
         this.captureError = this.captureError.bind(this);
     }
-    Lib.prototype.captureError = function (event) {
+    captureError(event) {
         var _a, _b, _c, _d;
-        if (typeof ((_a = this.errorsOptions) === null || _a === void 0 ? void 0 : _a.sampleRate) === 'number' && this.errorsOptions.sampleRate > Math.random()) {
+        if (typeof ((_a = this.errorsOptions) === null || _a === void 0 ? void 0 : _a.sampleRate) === 'number' && this.errorsOptions.sampleRate >= Math.random()) {
             return;
         }
         this.submitError({
@@ -174,9 +107,8 @@ var Lib = /** @class */ (function () {
             // Stack trace of the error, if available.
             stackTrace: (_d = event.error) === null || _d === void 0 ? void 0 : _d.stack,
         }, true);
-    };
-    Lib.prototype.trackErrors = function (options) {
-        var _this = this;
+    }
+    trackErrors(options) {
         if (this.errorListenerExists || !this.canTrack()) {
             return defaultActions;
         }
@@ -184,23 +116,29 @@ var Lib = /** @class */ (function () {
         window.addEventListener('error', this.captureError);
         this.errorListenerExists = true;
         return {
-            stop: function () {
-                window.removeEventListener('error', _this.captureError);
+            stop: () => {
+                window.removeEventListener('error', this.captureError);
+                this.errorListenerExists = false;
             },
         };
-    };
-    Lib.prototype.submitError = function (payload, evokeCallback) {
+    }
+    submitError(payload, evokeCallback) {
         var _a, _b, _c;
-        var privateData = {
+        const privateData = {
             pid: this.projectID,
         };
-        var errorPayload = __assign({ pg: this.activePage ||
+        const errorPayload = {
+            pg: this.activePage ||
                 getPath({
                     hash: (_a = this.pageViewsOptions) === null || _a === void 0 ? void 0 : _a.hash,
                     search: (_b = this.pageViewsOptions) === null || _b === void 0 ? void 0 : _b.search,
-                }), lc: getLocale(), tz: getTimezone() }, payload);
+                }),
+            lc: getLocale(),
+            tz: getTimezone(),
+            ...payload,
+        };
         if (evokeCallback && ((_c = this.errorsOptions) === null || _c === void 0 ? void 0 : _c.callback)) {
-            var callbackResult = this.errorsOptions.callback(errorPayload);
+            const callbackResult = this.errorsOptions.callback(errorPayload);
             if (callbackResult === false) {
                 return;
             }
@@ -210,26 +148,33 @@ var Lib = /** @class */ (function () {
         }
         Object.assign(errorPayload, privateData);
         this.sendRequest('error', errorPayload);
-    };
-    Lib.prototype.track = function (event) {
-        return __awaiter(this, void 0, void 0, function () {
-            var data;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        if (!this.canTrack()) {
-                            return [2 /*return*/];
-                        }
-                        data = __assign(__assign({}, event), { pid: this.projectID, pg: this.activePage, lc: getLocale(), tz: getTimezone(), ref: getReferrer(), so: getUTMSource(), me: getUTMMedium(), ca: getUTMCampaign(), te: getUTMTerm(), co: getUTMContent() });
-                        return [4 /*yield*/, this.sendRequest('custom', data)];
-                    case 1:
-                        _a.sent();
-                        return [2 /*return*/];
-                }
-            });
-        });
-    };
-    Lib.prototype.trackPageViews = function (options) {
+    }
+    async track(event) {
+        var _a, _b, _c, _d;
+        if (!this.canTrack()) {
+            return;
+        }
+        const data = {
+            ...event,
+            pid: this.projectID,
+            pg: this.activePage ||
+                getPath({
+                    hash: (_a = this.pageViewsOptions) === null || _a === void 0 ? void 0 : _a.hash,
+                    search: (_b = this.pageViewsOptions) === null || _b === void 0 ? void 0 : _b.search,
+                }),
+            lc: getLocale(),
+            tz: getTimezone(),
+            ref: getReferrer(),
+            so: getUTMSource(),
+            me: getUTMMedium(),
+            ca: getUTMCampaign(),
+            te: getUTMTerm(),
+            co: getUTMContent(),
+            profileId: (_c = event.profileId) !== null && _c !== void 0 ? _c : (_d = this.options) === null || _d === void 0 ? void 0 : _d.profileId,
+        };
+        await this.sendRequest('custom', data);
+    }
+    trackPageViews(options) {
         if (!this.canTrack()) {
             return defaultActions;
         }
@@ -237,20 +182,20 @@ var Lib = /** @class */ (function () {
             return this.pageData.actions;
         }
         this.pageViewsOptions = options;
-        var interval;
+        let interval;
         if (!(options === null || options === void 0 ? void 0 : options.unique)) {
             interval = setInterval(this.trackPathChange, 2000);
         }
         setTimeout(this.heartbeat, 3000);
-        var hbInterval = setInterval(this.heartbeat, 28000);
-        var path = getPath({
+        const hbInterval = setInterval(this.heartbeat, 28000);
+        const path = getPath({
             hash: options === null || options === void 0 ? void 0 : options.hash,
             search: options === null || options === void 0 ? void 0 : options.search,
         });
         this.pageData = {
-            path: path,
+            path,
             actions: {
-                stop: function () {
+                stop: () => {
                     clearInterval(interval);
                     clearInterval(hbInterval);
                 },
@@ -258,13 +203,13 @@ var Lib = /** @class */ (function () {
         };
         this.trackPage(path, options === null || options === void 0 ? void 0 : options.unique);
         return this.pageData.actions;
-    };
-    Lib.prototype.getPerformanceStats = function () {
+    }
+    getPerformanceStats() {
         var _a;
         if (!this.canTrack() || this.perfStatsCollected || !((_a = window.performance) === null || _a === void 0 ? void 0 : _a.getEntriesByType)) {
             return {};
         }
-        var perf = window.performance.getEntriesByType('navigation')[0];
+        const perf = window.performance.getEntriesByType('navigation')[0];
         if (!perf) {
             return {};
         }
@@ -284,50 +229,323 @@ var Lib = /** @class */ (function () {
             // Backend
             ttfb: perf.responseStart - perf.requestStart,
         };
-    };
-    Lib.prototype.heartbeat = function () {
+    }
+    /**
+     * Fetches all feature flags and experiments for the project.
+     * Results are cached for 5 minutes by default.
+     *
+     * @param options - Options for evaluating feature flags.
+     * @param forceRefresh - If true, bypasses the cache and fetches fresh data.
+     * @returns A promise that resolves to a record of flag keys to boolean values.
+     */
+    async getFeatureFlags(options, forceRefresh) {
+        var _a, _b, _c, _d;
+        if (!isInBrowser()) {
+            return {};
+        }
+        const requestedProfileId = (_a = options === null || options === void 0 ? void 0 : options.profileId) !== null && _a !== void 0 ? _a : (_b = this.options) === null || _b === void 0 ? void 0 : _b.profileId;
+        // Check cache first - must match profileId and not be expired
+        if (!forceRefresh && this.cachedData) {
+            const now = Date.now();
+            const isSameProfile = this.cachedData.profileId === requestedProfileId;
+            if (isSameProfile && now - this.cachedData.timestamp < DEFAULT_CACHE_DURATION) {
+                return this.cachedData.flags;
+            }
+        }
+        try {
+            await this.fetchFlagsAndExperiments(options);
+            return ((_c = this.cachedData) === null || _c === void 0 ? void 0 : _c.flags) || {};
+        }
+        catch (error) {
+            console.warn('[Swetrix] Error fetching feature flags:', error);
+            return ((_d = this.cachedData) === null || _d === void 0 ? void 0 : _d.flags) || {};
+        }
+    }
+    /**
+     * Internal method to fetch both feature flags and experiments from the API.
+     */
+    async fetchFlagsAndExperiments(options) {
+        var _a, _b, _c, _d;
+        const apiBase = this.getApiBase();
+        const body = {
+            pid: this.projectID,
+        };
+        // Use profileId from options, or fall back to global profileId
+        const profileId = (_a = options === null || options === void 0 ? void 0 : options.profileId) !== null && _a !== void 0 ? _a : (_b = this.options) === null || _b === void 0 ? void 0 : _b.profileId;
+        if (profileId) {
+            body.profileId = profileId;
+        }
+        const response = await fetch(`${apiBase}/feature-flag/evaluate`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            console.warn('[Swetrix] Failed to fetch feature flags and experiments:', response.status);
+            return;
+        }
+        const data = (await response.json());
+        // Use profileId from options, or fall back to global profileId
+        const cachedProfileId = (_c = options === null || options === void 0 ? void 0 : options.profileId) !== null && _c !== void 0 ? _c : (_d = this.options) === null || _d === void 0 ? void 0 : _d.profileId;
+        // Update cache with both flags and experiments
+        this.cachedData = {
+            flags: data.flags || {},
+            experiments: data.experiments || {},
+            timestamp: Date.now(),
+            profileId: cachedProfileId,
+        };
+    }
+    /**
+     * Gets the value of a single feature flag.
+     *
+     * @param key - The feature flag key.
+     * @param options - Options for evaluating the feature flag.
+     * @param defaultValue - Default value to return if the flag is not found. Defaults to false.
+     * @returns A promise that resolves to the boolean value of the flag.
+     */
+    async getFeatureFlag(key, options, defaultValue = false) {
+        var _a;
+        const flags = await this.getFeatureFlags(options);
+        return (_a = flags[key]) !== null && _a !== void 0 ? _a : defaultValue;
+    }
+    /**
+     * Clears the cached feature flags and experiments, forcing a fresh fetch on the next call.
+     */
+    clearFeatureFlagsCache() {
+        this.cachedData = null;
+    }
+    /**
+     * Fetches all A/B test experiments for the project.
+     * Results are cached for 5 minutes by default (shared cache with feature flags).
+     *
+     * @param options - Options for evaluating experiments.
+     * @param forceRefresh - If true, bypasses the cache and fetches fresh data.
+     * @returns A promise that resolves to a record of experiment IDs to variant keys.
+     *
+     * @example
+     * ```typescript
+     * const experiments = await getExperiments()
+     * // experiments = { 'exp-123': 'variant-a', 'exp-456': 'control' }
+     * ```
+     */
+    async getExperiments(options, forceRefresh) {
+        var _a, _b, _c, _d;
+        if (!isInBrowser()) {
+            return {};
+        }
+        const requestedProfileId = (_a = options === null || options === void 0 ? void 0 : options.profileId) !== null && _a !== void 0 ? _a : (_b = this.options) === null || _b === void 0 ? void 0 : _b.profileId;
+        // Check cache first - must match profileId and not be expired
+        if (!forceRefresh && this.cachedData) {
+            const now = Date.now();
+            const isSameProfile = this.cachedData.profileId === requestedProfileId;
+            if (isSameProfile && now - this.cachedData.timestamp < DEFAULT_CACHE_DURATION) {
+                return this.cachedData.experiments;
+            }
+        }
+        try {
+            await this.fetchFlagsAndExperiments(options);
+            return ((_c = this.cachedData) === null || _c === void 0 ? void 0 : _c.experiments) || {};
+        }
+        catch (error) {
+            console.warn('[Swetrix] Error fetching experiments:', error);
+            return ((_d = this.cachedData) === null || _d === void 0 ? void 0 : _d.experiments) || {};
+        }
+    }
+    /**
+     * Gets the variant key for a specific A/B test experiment.
+     *
+     * @param experimentId - The experiment ID.
+     * @param options - Options for evaluating the experiment.
+     * @param defaultVariant - Default variant key to return if the experiment is not found. Defaults to null.
+     * @returns A promise that resolves to the variant key assigned to this user, or defaultVariant if not found.
+     *
+     * @example
+     * ```typescript
+     * const variant = await getExperiment('checkout-redesign')
+     *
+     * if (variant === 'new-checkout') {
+     *   // Show new checkout flow
+     * } else {
+     *   // Show control (original) checkout
+     * }
+     * ```
+     */
+    async getExperiment(experimentId, options, defaultVariant = null) {
+        var _a;
+        const experiments = await this.getExperiments(options);
+        return (_a = experiments[experimentId]) !== null && _a !== void 0 ? _a : defaultVariant;
+    }
+    /**
+     * Clears the cached experiments (alias for clearFeatureFlagsCache since they share the same cache).
+     */
+    clearExperimentsCache() {
+        this.cachedData = null;
+    }
+    /**
+     * Gets the anonymous profile ID for the current visitor.
+     * If profileId was set via init options, returns that.
+     * Otherwise, requests server to generate one from IP/UA hash.
+     *
+     * This ID can be used for revenue attribution with payment providers.
+     *
+     * @returns A promise that resolves to the profile ID string, or null on error.
+     *
+     * @example
+     * ```typescript
+     * const profileId = await swetrix.getProfileId()
+     *
+     * // Pass to Paddle Checkout for revenue attribution
+     * Paddle.Checkout.open({
+     *   items: [{ priceId: 'pri_01234567890', quantity: 1 }],
+     *   customData: {
+     *     swetrix_profile_id: profileId,
+     *     swetrix_session_id: await swetrix.getSessionId()
+     *   }
+     * })
+     * ```
+     */
+    async getProfileId() {
+        var _a;
+        // If profileId is already set in options, return it
+        if ((_a = this.options) === null || _a === void 0 ? void 0 : _a.profileId) {
+            return this.options.profileId;
+        }
+        if (!isInBrowser()) {
+            return null;
+        }
+        try {
+            const apiBase = this.getApiBase();
+            const response = await fetch(`${apiBase}/log/profile-id`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ pid: this.projectID }),
+            });
+            if (!response.ok) {
+                return null;
+            }
+            const data = (await response.json());
+            return data.profileId;
+        }
+        catch (_b) {
+            return null;
+        }
+    }
+    /**
+     * Gets the current session ID for the visitor.
+     * Session IDs are generated server-side based on IP and user agent.
+     *
+     * This ID can be used for revenue attribution with payment providers.
+     *
+     * @returns A promise that resolves to the session ID string, or null on error.
+     *
+     * @example
+     * ```typescript
+     * const sessionId = await swetrix.getSessionId()
+     *
+     * // Pass to Paddle Checkout for revenue attribution
+     * Paddle.Checkout.open({
+     *   items: [{ priceId: 'pri_01234567890', quantity: 1 }],
+     *   customData: {
+     *     swetrix_profile_id: await swetrix.getProfileId(),
+     *     swetrix_session_id: sessionId
+     *   }
+     * })
+     * ```
+     */
+    async getSessionId() {
+        if (!isInBrowser()) {
+            return null;
+        }
+        try {
+            const apiBase = this.getApiBase();
+            const response = await fetch(`${apiBase}/log/session-id`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ pid: this.projectID }),
+            });
+            if (!response.ok) {
+                return null;
+            }
+            const data = (await response.json());
+            return data.sessionId;
+        }
+        catch (_a) {
+            return null;
+        }
+    }
+    /**
+     * Gets the API base URL (without /log suffix).
+     */
+    getApiBase() {
         var _a;
+        if ((_a = this.options) === null || _a === void 0 ? void 0 : _a.apiURL) {
+            // Remove trailing /log if present
+            return this.options.apiURL.replace(/\/log\/?$/, '');
+        }
+        return DEFAULT_API_BASE;
+    }
+    heartbeat() {
+        var _a, _b;
         if (!((_a = this.pageViewsOptions) === null || _a === void 0 ? void 0 : _a.heartbeatOnBackground) && document.visibilityState === 'hidden') {
             return;
         }
-        var data = {
+        const data = {
             pid: this.projectID,
         };
+        if ((_b = this.options) === null || _b === void 0 ? void 0 : _b.profileId) {
+            data.profileId = this.options.profileId;
+        }
         this.sendRequest('hb', data);
-    };
+    }
     // Tracking path changes. If path changes -> calling this.trackPage method
-    Lib.prototype.trackPathChange = function () {
+    trackPathChange() {
         var _a, _b;
         if (!this.pageData)
             return;
-        var newPath = getPath({
+        const newPath = getPath({
             hash: (_a = this.pageViewsOptions) === null || _a === void 0 ? void 0 : _a.hash,
             search: (_b = this.pageViewsOptions) === null || _b === void 0 ? void 0 : _b.search,
         });
-        var path = this.pageData.path;
+        const { path } = this.pageData;
         if (path !== newPath) {
             this.trackPage(newPath, false);
         }
-    };
-    Lib.prototype.trackPage = function (pg, unique) {
-        if (unique === void 0) { unique = false; }
+    }
+    trackPage(pg, unique = false) {
         if (!this.pageData)
             return;
         this.pageData.path = pg;
-        var perf = this.getPerformanceStats();
+        const perf = this.getPerformanceStats();
         this.activePage = pg;
-        this.submitPageView({ pg: pg }, unique, perf, true);
-    };
-    Lib.prototype.submitPageView = function (payload, unique, perf, evokeCallback) {
-        var _a;
-        var privateData = {
+        this.submitPageView({ pg }, unique, perf, true);
+    }
+    submitPageView(payload, unique, perf, evokeCallback) {
+        var _a, _b;
+        const privateData = {
             pid: this.projectID,
-            perf: perf,
-            unique: unique,
+            perf,
+            unique,
         };
-        var pvPayload = __assign({ lc: getLocale(), tz: getTimezone(), ref: getReferrer(), so: getUTMSource(), me: getUTMMedium(), ca: getUTMCampaign(), te: getUTMTerm(), co: getUTMContent() }, payload);
-        if (evokeCallback && ((_a = this.pageViewsOptions) === null || _a === void 0 ? void 0 : _a.callback)) {
-            var callbackResult = this.pageViewsOptions.callback(pvPayload);
+        const pvPayload = {
+            lc: getLocale(),
+            tz: getTimezone(),
+            ref: getReferrer(),
+            so: getUTMSource(),
+            me: getUTMMedium(),
+            ca: getUTMCampaign(),
+            te: getUTMTerm(),
+            co: getUTMContent(),
+            profileId: (_a = this.options) === null || _a === void 0 ? void 0 : _a.profileId,
+            ...payload,
+        };
+        if (evokeCallback && ((_b = this.pageViewsOptions) === null || _b === void 0 ? void 0 : _b.callback)) {
+            const callbackResult = this.pageViewsOptions.callback(pvPayload);
             if (callbackResult === false) {
                 return;
             }
@@ -337,8 +555,8 @@ var Lib = /** @class */ (function () {
         }
         Object.assign(pvPayload, privateData);
         this.sendRequest('', pvPayload);
-    };
-    Lib.prototype.canTrack = function () {
+    }
+    canTrack() {
         var _a, _b, _c, _d;
         if (((_a = this.options) === null || _a === void 0 ? void 0 : _a.disabled) ||
             !isInBrowser() ||
@@ -348,33 +566,21 @@ var Lib = /** @class */ (function () {
             return false;
         }
         return true;
-    };
-    Lib.prototype.sendRequest = function (path, body) {
-        return __awaiter(this, void 0, void 0, function () {
-            var host;
-            var _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        host = ((_a = this.options) === null || _a === void 0 ? void 0 : _a.apiURL) || DEFAULT_API_HOST;
-                        return [4 /*yield*/, fetch("".concat(host, "/").concat(path), {
-                                method: 'POST',
-                                headers: {
-                                    'Content-Type': 'application/json',
-                                },
-                                body: JSON.stringify(body),
-                            })];
-                    case 1:
-                        _b.sent();
-                        return [2 /*return*/];
-                }
-            });
+    }
+    async sendRequest(path, body) {
+        var _a;
+        const host = ((_a = this.options) === null || _a === void 0 ? void 0 : _a.apiURL) || DEFAULT_API_HOST;
+        await fetch(`${host}/${path}`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
         });
-    };
-    return Lib;
-}());
+    }
+}
 
-var LIB_INSTANCE = null;
+let LIB_INSTANCE = null;
 /**
  * Initialise the tracking library instance (other methods won't work if the library is not initialised).
  *
@@ -395,20 +601,10 @@ function init(pid, options) {
  *
  * @param {TrackEventOptions} event The options related to the custom event.
  */
-function track(event) {
-    return __awaiter(this, void 0, void 0, function () {
-        return __generator(this, function (_a) {
-            switch (_a.label) {
-                case 0:
-                    if (!LIB_INSTANCE)
-                        return [2 /*return*/];
-                    return [4 /*yield*/, LIB_INSTANCE.track(event)];
-                case 1:
-                    _a.sent();
-                    return [2 /*return*/];
-            }
-        });
-    });
+async function track(event) {
+    if (!LIB_INSTANCE)
+        return;
+    await LIB_INSTANCE.track(event);
 }
 /**
  * With this function you are able to automatically track pageviews across your application.
@@ -417,7 +613,7 @@ function track(event) {
  * @returns {PageActions} The actions related to the tracking. Used to stop tracking pages.
  */
 function trackViews(options) {
-    return new Promise(function (resolve) {
+    return new Promise((resolve) => {
         if (!LIB_INSTANCE) {
             resolve(defaultActions);
             return;
@@ -427,7 +623,7 @@ function trackViews(options) {
             resolve(LIB_INSTANCE.trackPageViews(options));
         }
         else {
-            window.addEventListener('load', function () {
+            window.addEventListener('load', () => {
                 // @ts-ignore
                 resolve(LIB_INSTANCE.trackPageViews(options));
             });
@@ -471,13 +667,189 @@ function trackError(payload) {
 function trackPageview(pg, _prev, unique) {
     if (!LIB_INSTANCE)
         return;
-    LIB_INSTANCE.submitPageView({ pg: pg }, Boolean(unique), {});
+    LIB_INSTANCE.submitPageView({ pg }, Boolean(unique), {});
 }
 function pageview(options) {
     if (!LIB_INSTANCE)
         return;
     LIB_INSTANCE.submitPageView(options.payload, Boolean(options.unique), {});
 }
+/**
+ * Fetches all feature flags for the project.
+ * Results are cached for 5 minutes by default.
+ *
+ * @param options - Options for evaluating feature flags (visitorId, attributes).
+ * @param forceRefresh - If true, bypasses the cache and fetches fresh flags.
+ * @returns A promise that resolves to a record of flag keys to boolean values.
+ *
+ * @example
+ * ```typescript
+ * const flags = await getFeatureFlags({
+ *   visitorId: 'user-123',
+ *   attributes: { cc: 'US', dv: 'desktop' }
+ * })
+ *
+ * if (flags['new-checkout']) {
+ *   // Show new checkout flow
+ * }
+ * ```
+ */
+async function getFeatureFlags(options, forceRefresh) {
+    if (!LIB_INSTANCE)
+        return {};
+    return LIB_INSTANCE.getFeatureFlags(options, forceRefresh);
+}
+/**
+ * Gets the value of a single feature flag.
+ *
+ * @param key - The feature flag key.
+ * @param options - Options for evaluating the feature flag (visitorId, attributes).
+ * @param defaultValue - Default value to return if the flag is not found. Defaults to false.
+ * @returns A promise that resolves to the boolean value of the flag.
+ *
+ * @example
+ * ```typescript
+ * const isEnabled = await getFeatureFlag('dark-mode', { visitorId: 'user-123' })
+ *
+ * if (isEnabled) {
+ *   // Enable dark mode
+ * }
+ * ```
+ */
+async function getFeatureFlag(key, options, defaultValue = false) {
+    if (!LIB_INSTANCE)
+        return defaultValue;
+    return LIB_INSTANCE.getFeatureFlag(key, options, defaultValue);
+}
+/**
+ * Clears the cached feature flags, forcing a fresh fetch on the next call.
+ * Useful when you know the user's context has changed significantly.
+ */
+function clearFeatureFlagsCache() {
+    if (!LIB_INSTANCE)
+        return;
+    LIB_INSTANCE.clearFeatureFlagsCache();
+}
+/**
+ * Fetches all A/B test experiments for the project.
+ * Results are cached for 5 minutes by default (shared cache with feature flags).
+ *
+ * @param options - Options for evaluating experiments.
+ * @param forceRefresh - If true, bypasses the cache and fetches fresh data.
+ * @returns A promise that resolves to a record of experiment IDs to variant keys.
+ *
+ * @example
+ * ```typescript
+ * const experiments = await getExperiments()
+ * // experiments = { 'exp-123': 'variant-a', 'exp-456': 'control' }
+ *
+ * // Use the assigned variant
+ * const checkoutVariant = experiments['checkout-experiment-id']
+ * if (checkoutVariant === 'new-checkout') {
+ *   showNewCheckout()
+ * } else {
+ *   showOriginalCheckout()
+ * }
+ * ```
+ */
+async function getExperiments(options, forceRefresh) {
+    if (!LIB_INSTANCE)
+        return {};
+    return LIB_INSTANCE.getExperiments(options, forceRefresh);
+}
+/**
+ * Gets the variant key for a specific A/B test experiment.
+ *
+ * @param experimentId - The experiment ID.
+ * @param options - Options for evaluating the experiment.
+ * @param defaultVariant - Default variant key to return if the experiment is not found. Defaults to null.
+ * @returns A promise that resolves to the variant key assigned to this user, or defaultVariant if not found.
+ *
+ * @example
+ * ```typescript
+ * const variant = await getExperiment('checkout-redesign-experiment-id')
+ *
+ * if (variant === 'new-checkout') {
+ *   // Show new checkout flow
+ *   showNewCheckout()
+ * } else if (variant === 'control') {
+ *   // Show original checkout (control group)
+ *   showOriginalCheckout()
+ * } else {
+ *   // Experiment not running or user not included
+ *   showOriginalCheckout()
+ * }
+ * ```
+ */
+async function getExperiment(experimentId, options, defaultVariant = null) {
+    if (!LIB_INSTANCE)
+        return defaultVariant;
+    return LIB_INSTANCE.getExperiment(experimentId, options, defaultVariant);
+}
+/**
+ * Clears the cached experiments, forcing a fresh fetch on the next call.
+ * This is an alias for clearFeatureFlagsCache since experiments and flags share the same cache.
+ */
+function clearExperimentsCache() {
+    if (!LIB_INSTANCE)
+        return;
+    LIB_INSTANCE.clearExperimentsCache();
+}
+/**
+ * Gets the anonymous profile ID for the current visitor.
+ * If profileId was set via init options, returns that.
+ * Otherwise, requests server to generate one from IP/UA hash.
+ *
+ * This ID can be used for revenue attribution with payment providers like Paddle.
+ *
+ * @returns A promise that resolves to the profile ID string, or null on error.
+ *
+ * @example
+ * ```typescript
+ * const profileId = await getProfileId()
+ *
+ * // Pass to Paddle Checkout for revenue attribution
+ * Paddle.Checkout.open({
+ *   items: [{ priceId: 'pri_01234567890', quantity: 1 }],
+ *   customData: {
+ *     swetrix_profile_id: profileId,
+ *     swetrix_session_id: await getSessionId()
+ *   }
+ * })
+ * ```
+ */
+async function getProfileId() {
+    if (!LIB_INSTANCE)
+        return null;
+    return LIB_INSTANCE.getProfileId();
+}
+/**
+ * Gets the current session ID for the visitor.
+ * Session IDs are generated server-side based on IP and user agent.
+ *
+ * This ID can be used for revenue attribution with payment providers like Paddle.
+ *
+ * @returns A promise that resolves to the session ID string, or null on error.
+ *
+ * @example
+ * ```typescript
+ * const sessionId = await getSessionId()
+ *
+ * // Pass to Paddle Checkout for revenue attribution
+ * Paddle.Checkout.open({
+ *   items: [{ priceId: 'pri_01234567890', quantity: 1 }],
+ *   customData: {
+ *     swetrix_profile_id: await getProfileId(),
+ *     swetrix_session_id: sessionId
+ *   }
+ * })
+ * ```
+ */
+async function getSessionId() {
+    if (!LIB_INSTANCE)
+        return null;
+    return LIB_INSTANCE.getSessionId();
+}
 
-export { LIB_INSTANCE, init, pageview, track, trackError, trackErrors, trackPageview, trackViews };
+export { LIB_INSTANCE, clearExperimentsCache, clearFeatureFlagsCache, getExperiment, getExperiments, getFeatureFlag, getFeatureFlags, getProfileId, getSessionId, init, pageview, track, trackError, trackErrors, trackPageview, trackViews };
 //# sourceMappingURL=swetrix.es5.js.map