posthog-js-lite 3.5.1 → 4.0.0

package/lib/index.cjs

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var version = "3.5.1";
+var version = "4.0.0";
 
 var PostHogPersistedProperty;
 (function (PostHogPersistedProperty) {
@@ -19,6 +19,7 @@ var PostHogPersistedProperty;
     PostHogPersistedProperty["Queue"] = "queue";
     PostHogPersistedProperty["OptedOut"] = "opted_out";
     PostHogPersistedProperty["SessionId"] = "session_id";
+    PostHogPersistedProperty["SessionStartTimestamp"] = "session_start_timestamp";
     PostHogPersistedProperty["SessionLastTimestamp"] = "session_timestamp";
     PostHogPersistedProperty["PersonProperties"] = "person_properties";
     PostHogPersistedProperty["GroupProperties"] = "group_properties";
@@ -31,6 +32,12 @@ var PostHogPersistedProperty;
     PostHogPersistedProperty["Surveys"] = "surveys";
     PostHogPersistedProperty["RemoteConfig"] = "remote_config";
 })(PostHogPersistedProperty || (PostHogPersistedProperty = {}));
+// Any key prefixed with `attr__` can be added
+var Compression;
+(function (Compression) {
+    Compression["GZipJS"] = "gzip-js";
+    Compression["Base64"] = "base64";
+})(Compression || (Compression = {}));
 var SurveyPosition;
 (function (SurveyPosition) {
     SurveyPosition["Left"] = "left";
@@ -371,438 +378,38 @@ function isTokenInRollout(token, percentage = 0, excludedHashes) {
     const hashInt = parseInt(tokenHash, 16);
     const hashFloat = hashInt / 0xffffffff;
     return hashFloat < percentage;
+}
+function allSettled(promises) {
+    return Promise.all(promises.map((p) => (p ?? Promise.resolve()).then((value) => ({ status: 'fulfilled', value }), (reason) => ({ status: 'rejected', reason }))));
 }
 
-// Copyright (c) 2013 Pieroxy <pieroxy@pieroxy.net>
-// This work is free. You can redistribute it and/or modify it
-// under the terms of the WTFPL, Version 2
-// For more information see LICENSE.txt or http://www.wtfpl.net/
-//
-// For more information, the home page:
-// http://pieroxy.net/blog/pages/lz-string/testing.html
-//
-// LZ-based compression algorithm, version 1.4.4
-// private property
-const f = String.fromCharCode;
-const keyStrBase64 = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=';
-const baseReverseDic = {};
-function getBaseValue(alphabet, character) {
-    if (!baseReverseDic[alphabet]) {
-        baseReverseDic[alphabet] = {};
-        for (let i = 0; i < alphabet.length; i++) {
-            baseReverseDic[alphabet][alphabet.charAt(i)] = i;
-        }
-    }
-    return baseReverseDic[alphabet][character];
+/**
+ * Older browsers and some runtimes don't support this yet
+ * This API (as of 2025-05-07) is not available on React Native.
+ */
+function isGzipSupported() {
+    return 'CompressionStream' in globalThis;
 }
-const LZString = {
-    compressToBase64: function (input) {
-        if (input == null) {
-            return '';
-        }
-        const res = LZString._compress(input, 6, function (a) {
-            return keyStrBase64.charAt(a);
-        });
-        switch (res.length % 4 // To produce valid Base64
-        ) {
-            default: // When could this happen ?
-            case 0:
-                return res;
-            case 1:
-                return res + '===';
-            case 2:
-                return res + '==';
-            case 3:
-                return res + '=';
-        }
-    },
-    decompressFromBase64: function (input) {
-        if (input == null) {
-            return '';
-        }
-        if (input == '') {
-            return null;
-        }
-        return LZString._decompress(input.length, 32, function (index) {
-            return getBaseValue(keyStrBase64, input.charAt(index));
-        });
-    },
-    compress: function (uncompressed) {
-        return LZString._compress(uncompressed, 16, function (a) {
-            return f(a);
-        });
-    },
-    _compress: function (uncompressed, bitsPerChar, getCharFromInt) {
-        if (uncompressed == null) {
-            return '';
-        }
-        const context_dictionary = {}, context_dictionaryToCreate = {}, context_data = [];
-        let i, value, context_c = '', context_wc = '', context_w = '', context_enlargeIn = 2, // Compensate for the first entry which should not count
-        context_dictSize = 3, context_numBits = 2, context_data_val = 0, context_data_position = 0, ii;
-        for (ii = 0; ii < uncompressed.length; ii += 1) {
-            context_c = uncompressed.charAt(ii);
-            if (!Object.prototype.hasOwnProperty.call(context_dictionary, context_c)) {
-                context_dictionary[context_c] = context_dictSize++;
-                context_dictionaryToCreate[context_c] = true;
-            }
-            context_wc = context_w + context_c;
-            if (Object.prototype.hasOwnProperty.call(context_dictionary, context_wc)) {
-                context_w = context_wc;
-            }
-            else {
-                if (Object.prototype.hasOwnProperty.call(context_dictionaryToCreate, context_w)) {
-                    if (context_w.charCodeAt(0) < 256) {
-                        for (i = 0; i < context_numBits; i++) {
-                            context_data_val = context_data_val << 1;
-                            if (context_data_position == bitsPerChar - 1) {
-                                context_data_position = 0;
-                                context_data.push(getCharFromInt(context_data_val));
-                                context_data_val = 0;
-                            }
-                            else {
-                                context_data_position++;
-                            }
-                        }
-                        value = context_w.charCodeAt(0);
-                        for (i = 0; i < 8; i++) {
-                            context_data_val = (context_data_val << 1) | (value & 1);
-                            if (context_data_position == bitsPerChar - 1) {
-                                context_data_position = 0;
-                                context_data.push(getCharFromInt(context_data_val));
-                                context_data_val = 0;
-                            }
-                            else {
-                                context_data_position++;
-                            }
-                            value = value >> 1;
-                        }
-                    }
-                    else {
-                        value = 1;
-                        for (i = 0; i < context_numBits; i++) {
-                            context_data_val = (context_data_val << 1) | value;
-                            if (context_data_position == bitsPerChar - 1) {
-                                context_data_position = 0;
-                                context_data.push(getCharFromInt(context_data_val));
-                                context_data_val = 0;
-                            }
-                            else {
-                                context_data_position++;
-                            }
-                            value = 0;
-                        }
-                        value = context_w.charCodeAt(0);
-                        for (i = 0; i < 16; i++) {
-                            context_data_val = (context_data_val << 1) | (value & 1);
-                            if (context_data_position == bitsPerChar - 1) {
-                                context_data_position = 0;
-                                context_data.push(getCharFromInt(context_data_val));
-                                context_data_val = 0;
-                            }
-                            else {
-                                context_data_position++;
-                            }
-                            value = value >> 1;
-                        }
-                    }
-                    context_enlargeIn--;
-                    if (context_enlargeIn == 0) {
-                        context_enlargeIn = Math.pow(2, context_numBits);
-                        context_numBits++;
-                    }
-                    delete context_dictionaryToCreate[context_w];
-                }
-                else {
-                    value = context_dictionary[context_w];
-                    for (i = 0; i < context_numBits; i++) {
-                        context_data_val = (context_data_val << 1) | (value & 1);
-                        if (context_data_position == bitsPerChar - 1) {
-                            context_data_position = 0;
-                            context_data.push(getCharFromInt(context_data_val));
-                            context_data_val = 0;
-                        }
-                        else {
-                            context_data_position++;
-                        }
-                        value = value >> 1;
-                    }
-                }
-                context_enlargeIn--;
-                if (context_enlargeIn == 0) {
-                    context_enlargeIn = Math.pow(2, context_numBits);
-                    context_numBits++;
-                }
-                // Add wc to the dictionary.
-                context_dictionary[context_wc] = context_dictSize++;
-                context_w = String(context_c);
-            }
-        }
-        // Output the code for w.
-        if (context_w !== '') {
-            if (Object.prototype.hasOwnProperty.call(context_dictionaryToCreate, context_w)) {
-                if (context_w.charCodeAt(0) < 256) {
-                    for (i = 0; i < context_numBits; i++) {
-                        context_data_val = context_data_val << 1;
-                        if (context_data_position == bitsPerChar - 1) {
-                            context_data_position = 0;
-                            context_data.push(getCharFromInt(context_data_val));
-                            context_data_val = 0;
-                        }
-                        else {
-                            context_data_position++;
-                        }
-                    }
-                    value = context_w.charCodeAt(0);
-                    for (i = 0; i < 8; i++) {
-                        context_data_val = (context_data_val << 1) | (value & 1);
-                        if (context_data_position == bitsPerChar - 1) {
-                            context_data_position = 0;
-                            context_data.push(getCharFromInt(context_data_val));
-                            context_data_val = 0;
-                        }
-                        else {
-                            context_data_position++;
-                        }
-                        value = value >> 1;
-                    }
-                }
-                else {
-                    value = 1;
-                    for (i = 0; i < context_numBits; i++) {
-                        context_data_val = (context_data_val << 1) | value;
-                        if (context_data_position == bitsPerChar - 1) {
-                            context_data_position = 0;
-                            context_data.push(getCharFromInt(context_data_val));
-                            context_data_val = 0;
-                        }
-                        else {
-                            context_data_position++;
-                        }
-                        value = 0;
-                    }
-                    value = context_w.charCodeAt(0);
-                    for (i = 0; i < 16; i++) {
-                        context_data_val = (context_data_val << 1) | (value & 1);
-                        if (context_data_position == bitsPerChar - 1) {
-                            context_data_position = 0;
-                            context_data.push(getCharFromInt(context_data_val));
-                            context_data_val = 0;
-                        }
-                        else {
-                            context_data_position++;
-                        }
-                        value = value >> 1;
-                    }
-                }
-                context_enlargeIn--;
-                if (context_enlargeIn == 0) {
-                    context_enlargeIn = Math.pow(2, context_numBits);
-                    context_numBits++;
-                }
-                delete context_dictionaryToCreate[context_w];
-            }
-            else {
-                value = context_dictionary[context_w];
-                for (i = 0; i < context_numBits; i++) {
-                    context_data_val = (context_data_val << 1) | (value & 1);
-                    if (context_data_position == bitsPerChar - 1) {
-                        context_data_position = 0;
-                        context_data.push(getCharFromInt(context_data_val));
-                        context_data_val = 0;
-                    }
-                    else {
-                        context_data_position++;
-                    }
-                    value = value >> 1;
-                }
-            }
-            context_enlargeIn--;
-            if (context_enlargeIn == 0) {
-                context_enlargeIn = Math.pow(2, context_numBits);
-                context_numBits++;
-            }
-        }
-        // Mark the end of the stream
-        value = 2;
-        for (i = 0; i < context_numBits; i++) {
-            context_data_val = (context_data_val << 1) | (value & 1);
-            if (context_data_position == bitsPerChar - 1) {
-                context_data_position = 0;
-                context_data.push(getCharFromInt(context_data_val));
-                context_data_val = 0;
-            }
-            else {
-                context_data_position++;
-            }
-            value = value >> 1;
-        }
-        // Flush the last char
-        while (true) {
-            context_data_val = context_data_val << 1;
-            if (context_data_position == bitsPerChar - 1) {
-                context_data.push(getCharFromInt(context_data_val));
-                break;
-            }
-            else {
-                context_data_position++;
-            }
-        }
-        return context_data.join('');
-    },
-    decompress: function (compressed) {
-        if (compressed == null) {
-            return '';
-        }
-        if (compressed == '') {
-            return null;
-        }
-        return LZString._decompress(compressed.length, 32768, function (index) {
-            return compressed.charCodeAt(index);
-        });
-    },
-    _decompress: function (length, resetValue, getNextValue) {
-        const dictionary = [], result = [], data = { val: getNextValue(0), position: resetValue, index: 1 };
-        let enlargeIn = 4, dictSize = 4, numBits = 3, entry = '', i, w, bits, resb, maxpower, power, c;
-        for (i = 0; i < 3; i += 1) {
-            dictionary[i] = i;
-        }
-        bits = 0;
-        maxpower = Math.pow(2, 2);
-        power = 1;
-        while (power != maxpower) {
-            resb = data.val & data.position;
-            data.position >>= 1;
-            if (data.position == 0) {
-                data.position = resetValue;
-                data.val = getNextValue(data.index++);
-            }
-            bits |= (resb > 0 ? 1 : 0) * power;
-            power <<= 1;
-        }
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        switch ((bits)) {
-            case 0:
-                bits = 0;
-                maxpower = Math.pow(2, 8);
-                power = 1;
-                while (power != maxpower) {
-                    resb = data.val & data.position;
-                    data.position >>= 1;
-                    if (data.position == 0) {
-                        data.position = resetValue;
-                        data.val = getNextValue(data.index++);
-                    }
-                    bits |= (resb > 0 ? 1 : 0) * power;
-                    power <<= 1;
-                }
-                c = f(bits);
-                break;
-            case 1:
-                bits = 0;
-                maxpower = Math.pow(2, 16);
-                power = 1;
-                while (power != maxpower) {
-                    resb = data.val & data.position;
-                    data.position >>= 1;
-                    if (data.position == 0) {
-                        data.position = resetValue;
-                        data.val = getNextValue(data.index++);
-                    }
-                    bits |= (resb > 0 ? 1 : 0) * power;
-                    power <<= 1;
-                }
-                c = f(bits);
-                break;
-            case 2:
-                return '';
-        }
-        dictionary[3] = c;
-        w = c;
-        result.push(c);
-        while (true) {
-            if (data.index > length) {
-                return '';
-            }
-            bits = 0;
-            maxpower = Math.pow(2, numBits);
-            power = 1;
-            while (power != maxpower) {
-                resb = data.val & data.position;
-                data.position >>= 1;
-                if (data.position == 0) {
-                    data.position = resetValue;
-                    data.val = getNextValue(data.index++);
-                }
-                bits |= (resb > 0 ? 1 : 0) * power;
-                power <<= 1;
-            }
-            switch ((c = bits)) {
-                case 0:
-                    bits = 0;
-                    maxpower = Math.pow(2, 8);
-                    power = 1;
-                    while (power != maxpower) {
-                        resb = data.val & data.position;
-                        data.position >>= 1;
-                        if (data.position == 0) {
-                            data.position = resetValue;
-                            data.val = getNextValue(data.index++);
-                        }
-                        bits |= (resb > 0 ? 1 : 0) * power;
-                        power <<= 1;
-                    }
-                    dictionary[dictSize++] = f(bits);
-                    c = dictSize - 1;
-                    enlargeIn--;
-                    break;
-                case 1:
-                    bits = 0;
-                    maxpower = Math.pow(2, 16);
-                    power = 1;
-                    while (power != maxpower) {
-                        resb = data.val & data.position;
-                        data.position >>= 1;
-                        if (data.position == 0) {
-                            data.position = resetValue;
-                            data.val = getNextValue(data.index++);
-                        }
-                        bits |= (resb > 0 ? 1 : 0) * power;
-                        power <<= 1;
-                    }
-                    dictionary[dictSize++] = f(bits);
-                    c = dictSize - 1;
-                    enlargeIn--;
-                    break;
-                case 2:
-                    return result.join('');
-            }
-            if (enlargeIn == 0) {
-                enlargeIn = Math.pow(2, numBits);
-                numBits++;
-            }
-            if (dictionary[c]) {
-                entry = dictionary[c];
-            }
-            else {
-                if (c === dictSize) {
-                    entry = w + w.charAt(0);
-                }
-                else {
-                    return null;
-                }
-            }
-            result.push(entry);
-            // Add w+entry[0] to the dictionary.
-            dictionary[dictSize++] = w + entry.charAt(0);
-            enlargeIn--;
-            w = entry;
-            if (enlargeIn == 0) {
-                enlargeIn = Math.pow(2, numBits);
-                numBits++;
-            }
+/**
+ * Gzip a string using Compression Streams API if it's available
+ */
+async function gzipCompress(input, isDebug = true) {
+    try {
+        // Turn the string into a stream using a Blob, and then compress it
+        const dataStream = new Blob([input], {
+            type: 'text/plain',
+        }).stream();
+        const compressedStream = dataStream.pipeThrough(new CompressionStream('gzip'));
+        // Using a Response to easily extract the readablestream value. Decoding into a string for fetch
+        return await new Response(compressedStream).blob();
+    }
+    catch (error) {
+        if (isDebug) {
+            console.error('Failed to gzip compress data', error);
         }
-    },
-};
+        return null;
+    }
+}
 
 class SimpleEventEmitter {
     constructor() {
@@ -1261,6 +868,7 @@ class PostHogFetchNetworkError extends Error {
         this.name = 'PostHogFetchNetworkError';
     }
 }
+const maybeAdd = (key, value) => value !== undefined ? { [key]: value } : {};
 async function logFlushError(err) {
     if (err instanceof PostHogFetchHttpError) {
         let text = '';
@@ -1301,7 +909,6 @@ class PostHogCoreStateless {
         this.maxBatchSize = Math.max(this.flushAt, options?.maxBatchSize ?? 100);
         this.maxQueueSize = Math.max(this.flushAt, options?.maxQueueSize ?? 1000);
         this.flushInterval = options?.flushInterval ?? 10000;
-        this.captureMode = options?.captureMode || 'json';
         this.preloadFeatureFlags = options?.preloadFeatureFlags ?? true;
         // If enable is explicitly set to false we override the optout
         this.defaultOptIn = options?.defaultOptIn ?? true;
@@ -1320,6 +927,7 @@ class PostHogCoreStateless {
         // Init promise allows the derived class to block calls until it is ready
         this._initPromise = Promise.resolve();
         this._isInitialized = true;
+        this.disableCompression = !isGzipSupported() || (options?.disableCompression ?? false);
     }
     logMsgIfDebug(fn) {
         if (this.isDebug) {
@@ -1521,6 +1129,7 @@ class PostHogCoreStateless {
                 ...extraPayload,
             }),
         };
+        this.logMsgIfDebug(() => console.log('PostHog Debug', 'Decide URL', url));
         // Don't retry /decide API calls
         return this.fetchWithRetry(url, fetchOptions, { retryCount: 0 }, this.featureFlagsRequestTimeoutMs)
             .then((response) => response.json())
@@ -1638,7 +1247,7 @@ class PostHogCoreStateless {
     async getSurveysStateless() {
         await this._initPromise;
         if (this.disableSurveys === true) {
-            this.logMsgIfDebug(() => console.log('Loading surveys is disabled.'));
+            this.logMsgIfDebug(() => console.log('PostHog Debug', 'Loading surveys is disabled.'));
             return [];
         }
         const url = `${this.host}/api/surveys/?token=${this.apiKey}`;
@@ -1740,28 +1349,22 @@ class PostHogCoreStateless {
             data.historical_migration = true;
         }
         const payload = JSON.stringify(data);
-        const url = this.captureMode === 'form'
-            ? `${this.host}/e/?ip=1&_=${currentTimestamp()}&v=${this.getLibraryVersion()}`
-            : `${this.host}/batch/`;
-        const fetchOptions = this.captureMode === 'form'
-            ? {
-                method: 'POST',
-                mode: 'no-cors',
-                credentials: 'omit',
-                headers: { ...this.getCustomHeaders(), 'Content-Type': 'application/x-www-form-urlencoded' },
-                body: `data=${encodeURIComponent(LZString.compressToBase64(payload))}&compression=lz64`,
-            }
-            : {
-                method: 'POST',
-                headers: { ...this.getCustomHeaders(), 'Content-Type': 'application/json' },
-                body: payload,
-            };
+        const url = `${this.host}/batch/`;
+        const gzippedPayload = !this.disableCompression ? await gzipCompress(payload, this.isDebug) : null;
+        const fetchOptions = {
+            method: 'POST',
+            headers: {
+                ...this.getCustomHeaders(),
+                'Content-Type': 'application/json',
+                ...(gzippedPayload !== null && { 'Content-Encoding': 'gzip' }),
+            },
+            body: gzippedPayload || payload,
+        };
         try {
             await this.fetchWithRetry(url, fetchOptions);
         }
         catch (err) {
             this._events.emit('error', err);
-            throw err;
         }
     }
     prepareMessage(type, _message, options) {
@@ -1801,15 +1404,38 @@ class PostHogCoreStateless {
             await logFlushError(err);
         });
     }
+    /**
+     * Flushes the queue
+     *
+     * This function will return a promise that will resolve when the flush is complete,
+     * or reject if there was an error (for example if the server or network is down).
+     *
+     * If there is already a flush in progress, this function will wait for that flush to complete.
+     *
+     * It's recommended to do error handling in the callback of the promise.
+     *
+     * @example
+     * posthog.flush().then(() => {
+     *   console.log('Flush complete')
+     * }).catch((err) => {
+     *   console.error('Flush failed', err)
+     * })
+     *
+     *
+     * @throws PostHogFetchHttpError
+     * @throws PostHogFetchNetworkError
+     * @throws Error
+     */
     async flush() {
         // Wait for the current flush operation to finish (regardless of success or failure), then try to flush again.
         // Use allSettled instead of finally to be defensive around flush throwing errors immediately rather than rejecting.
-        const nextFlushPromise = Promise.allSettled([this.flushPromise]).then(() => {
+        // Use a custom allSettled implementation to avoid issues with patching Promise on RN
+        const nextFlushPromise = allSettled([this.flushPromise]).then(() => {
             return this._flush();
         });
         this.flushPromise = nextFlushPromise;
         void this.addPendingPromise(nextFlushPromise);
-        Promise.allSettled([nextFlushPromise]).then(() => {
+        allSettled([nextFlushPromise]).then(() => {
             // If there are no others waiting to flush, clear the promise.
             // We don't strictly need to do this, but it could make debugging easier
             if (this.flushPromise === nextFlushPromise) {
@@ -1835,7 +1461,7 @@ class PostHogCoreStateless {
         await this._initPromise;
         let queue = this.getPersistedProperty(PostHogPersistedProperty.Queue) || [];
         if (!queue.length) {
-            return [];
+            return;
         }
         const sentMessages = [];
         const originalQueueLength = queue.length;
@@ -1857,22 +1483,17 @@ class PostHogCoreStateless {
                 data.historical_migration = true;
             }
             const payload = JSON.stringify(data);
-            const url = this.captureMode === 'form'
-                ? `${this.host}/e/?ip=1&_=${currentTimestamp()}&v=${this.getLibraryVersion()}`
-                : `${this.host}/batch/`;
-            const fetchOptions = this.captureMode === 'form'
-                ? {
-                    method: 'POST',
-                    mode: 'no-cors',
-                    credentials: 'omit',
-                    headers: { ...this.getCustomHeaders(), 'Content-Type': 'application/x-www-form-urlencoded' },
-                    body: `data=${encodeURIComponent(LZString.compressToBase64(payload))}&compression=lz64`,
-                }
-                : {
-                    method: 'POST',
-                    headers: { ...this.getCustomHeaders(), 'Content-Type': 'application/json' },
-                    body: payload,
-                };
+            const url = `${this.host}/batch/`;
+            const gzippedPayload = !this.disableCompression ? await gzipCompress(payload, this.isDebug) : null;
+            const fetchOptions = {
+                method: 'POST',
+                headers: {
+                    ...this.getCustomHeaders(),
+                    'Content-Type': 'application/json',
+                    ...(gzippedPayload !== null && { 'Content-Encoding': 'gzip' }),
+                },
+                body: gzippedPayload || payload,
+            };
             const retryOptions = {
                 retryCheck: (err) => {
                     // don't automatically retry on 413 errors, we want to reduce the batch size first
@@ -1906,7 +1527,6 @@ class PostHogCoreStateless {
             sentMessages.push(...batchMessages);
         }
         this._events.emit('flush', sentMessages);
-        return sentMessages;
     }
     async fetchWithRetry(url, options, retryOptions, requestTimeout) {
         var _a;
@@ -1916,7 +1536,24 @@ class PostHogCoreStateless {
             return ctrl.signal;
         });
         const body = options.body ? options.body : '';
-        const reqByteLength = Buffer.byteLength(body, STRING_FORMAT);
+        let reqByteLength = -1;
+        try {
+            if (body instanceof Blob) {
+                reqByteLength = body.size;
+            }
+            else {
+                reqByteLength = Buffer.byteLength(body, STRING_FORMAT);
+            }
+        }
+        catch {
+            if (body instanceof Blob) {
+                reqByteLength = body.size;
+            }
+            else {
+                const encoded = new TextEncoder().encode(body);
+                reqByteLength = encoded.length;
+            }
+        }
         return await retriable(async () => {
             let res = null;
             try {
@@ -2005,6 +1642,7 @@ class PostHogCore extends PostHogCoreStateless {
         const featureFlagsRequestTimeoutMs = options?.featureFlagsRequestTimeoutMs ?? 10000; // 10 seconds
         super(apiKey, { ...options, disableGeoip: disableGeoipOption, featureFlagsRequestTimeoutMs });
         this.flagCallReported = {};
+        this._sessionMaxLengthSeconds = 24 * 60 * 60; // 24 hours
         this.sessionProps = {};
         this.sendFeatureFlagEvent = options?.sendFeatureFlagEvent ?? true;
         this._sessionExpirationTimeSeconds = options?.sessionExpirationTimeSeconds ?? 1800; // 30 minutes
@@ -2078,7 +1716,7 @@ class PostHogCore extends PostHogCoreStateless {
             }
         }
         return {
-            $active_feature_flags: featureFlags ? Object.keys(featureFlags) : undefined,
+            ...maybeAdd('$active_feature_flags', featureFlags ? Object.keys(featureFlags) : undefined),
             ...featureVariantProperties,
             ...super.getCommonEventProperties(),
         };
@@ -2100,18 +1738,26 @@ class PostHogCore extends PostHogCoreStateless {
             return '';
         }
         let sessionId = this.getPersistedProperty(PostHogPersistedProperty.SessionId);
-        const sessionTimestamp = this.getPersistedProperty(PostHogPersistedProperty.SessionLastTimestamp) || 0;
-        if (!sessionId || Date.now() - sessionTimestamp > this._sessionExpirationTimeSeconds * 1000) {
+        const sessionLastTimestamp = this.getPersistedProperty(PostHogPersistedProperty.SessionLastTimestamp) || 0;
+        const sessionStartTimestamp = this.getPersistedProperty(PostHogPersistedProperty.SessionStartTimestamp) || 0;
+        const now = Date.now();
+        const sessionLastDif = now - sessionLastTimestamp;
+        const sessionStartDif = now - sessionStartTimestamp;
+        if (!sessionId ||
+            sessionLastDif > this._sessionExpirationTimeSeconds * 1000 ||
+            sessionStartDif > this._sessionMaxLengthSeconds * 1000) {
             sessionId = uuidv7();
             this.setPersistedProperty(PostHogPersistedProperty.SessionId, sessionId);
+            this.setPersistedProperty(PostHogPersistedProperty.SessionStartTimestamp, now);
         }
-        this.setPersistedProperty(PostHogPersistedProperty.SessionLastTimestamp, Date.now());
+        this.setPersistedProperty(PostHogPersistedProperty.SessionLastTimestamp, now);
         return sessionId;
     }
     resetSessionId() {
         this.wrap(() => {
             this.setPersistedProperty(PostHogPersistedProperty.SessionId, null);
             this.setPersistedProperty(PostHogPersistedProperty.SessionLastTimestamp, null);
+            this.setPersistedProperty(PostHogPersistedProperty.SessionStartTimestamp, null);
         });
     }
     /**
@@ -2163,8 +1809,8 @@ class PostHogCore extends PostHogCoreStateless {
             const userProps = properties?.$set || properties;
             const allProperties = this.enrichProperties({
                 $anon_distinct_id: this.getAnonymousId(),
-                $set: userProps,
-                $set_once: userPropsOnce,
+                ...maybeAdd('$set', userProps),
+                ...maybeAdd('$set_once', userPropsOnce),
             });
             if (distinctId !== previousDistinctId) {
                 // We keep the AnonymousId to be used by decide calls and identify to link the previousId
@@ -2260,10 +1906,6 @@ class PostHogCore extends PostHogCoreStateless {
             this.setPersistedProperty(PostHogPersistedProperty.PersonProperties, null);
         });
     }
-    /** @deprecated - Renamed to setPersonPropertiesForFlags */
-    personProperties(properties) {
-        return this.setPersonPropertiesForFlags(properties);
-    }
     setGroupPropertiesForFlags(properties) {
         this.wrap(() => {
             // Get persisted group properties
@@ -2289,12 +1931,6 @@ class PostHogCore extends PostHogCoreStateless {
             this.setPersistedProperty(PostHogPersistedProperty.GroupProperties, null);
         });
     }
-    /** @deprecated - Renamed to setGroupPropertiesForFlags */
-    groupProperties(properties) {
-        this.wrap(() => {
-            this.setGroupPropertiesForFlags(properties);
-        });
-    }
     async remoteConfigAsync() {
         await this._initPromise;
         if (this._remoteConfigResponsePromise) {
@@ -2312,14 +1948,16 @@ class PostHogCore extends PostHogCoreStateless {
         }
         return this._decideAsync(sendAnonDistinctId);
     }
-    cacheSessionReplay(response) {
+    cacheSessionReplay(source, response) {
         const sessionReplay = response?.sessionRecording;
         if (sessionReplay) {
             this.setPersistedProperty(PostHogPersistedProperty.SessionReplay, sessionReplay);
-            this.logMsgIfDebug(() => console.log('PostHog Debug', 'Session replay config: ', JSON.stringify(sessionReplay)));
+            this.logMsgIfDebug(() => console.log('PostHog Debug', `Session replay config from ${source}: `, JSON.stringify(sessionReplay)));
         }
-        else {
-            this.logMsgIfDebug(() => console.info('PostHog Debug', 'Session replay config disabled.'));
+        else if (typeof sessionReplay === 'boolean' && sessionReplay === false) {
+            // if session replay is disabled, we don't need to cache it
+            // we need to check for this because the response might be undefined (/flags does not return sessionRecording yet)
+            this.logMsgIfDebug(() => console.info('PostHog Debug', `Session replay config from ${source} disabled.`));
             this.setPersistedProperty(PostHogPersistedProperty.SessionReplay, null);
         }
     }
@@ -2333,25 +1971,30 @@ class PostHogCore extends PostHogCoreStateless {
                     const remoteConfigWithoutSurveys = { ...response };
                     delete remoteConfigWithoutSurveys.surveys;
                     this.logMsgIfDebug(() => console.log('PostHog Debug', 'Fetched remote config: ', JSON.stringify(remoteConfigWithoutSurveys)));
-                    const surveys = response.surveys;
-                    let hasSurveys = true;
-                    if (!Array.isArray(surveys)) {
-                        // If surveys is not an array, it means there are no surveys (its a boolean instead)
-                        this.logMsgIfDebug(() => console.log('PostHog Debug', 'There are no surveys.'));
-                        hasSurveys = false;
-                    }
-                    else {
-                        this.logMsgIfDebug(() => console.log('PostHog Debug', 'Surveys fetched from remote config: ', JSON.stringify(surveys)));
-                    }
-                    if (this.disableSurveys === false && hasSurveys) {
-                        this.setPersistedProperty(PostHogPersistedProperty.Surveys, surveys);
+                    if (this.disableSurveys === false) {
+                        const surveys = response.surveys;
+                        let hasSurveys = true;
+                        if (!Array.isArray(surveys)) {
+                            // If surveys is not an array, it means there are no surveys (its a boolean instead)
+                            this.logMsgIfDebug(() => console.log('PostHog Debug', 'There are no surveys.'));
+                            hasSurveys = false;
+                        }
+                        else {
+                            this.logMsgIfDebug(() => console.log('PostHog Debug', 'Surveys fetched from remote config: ', JSON.stringify(surveys)));
+                        }
+                        if (hasSurveys) {
+                            this.setPersistedProperty(PostHogPersistedProperty.Surveys, surveys);
+                        }
+                        else {
+                            this.setPersistedProperty(PostHogPersistedProperty.Surveys, null);
+                        }
                     }
                     else {
                         this.setPersistedProperty(PostHogPersistedProperty.Surveys, null);
                     }
                     // we cache the surveys in its own storage key
                     this.setPersistedProperty(PostHogPersistedProperty.RemoteConfig, remoteConfigWithoutSurveys);
-                    this.cacheSessionReplay(response);
+                    this.cacheSessionReplay('remote config', response);
                     // we only dont load flags if the remote config has no feature flags
                     if (response.hasFeatureFlags === false) {
                         // resetting flags to empty object
@@ -2361,6 +2004,9 @@ class PostHogCore extends PostHogCoreStateless {
                     else if (this.preloadFeatureFlags !== false) {
                         this.reloadFeatureFlags();
                     }
+                    if (!response.supportedCompression?.includes(Compression.GZipJS)) {
+                        this.disableCompression = true;
+                    }
                     remoteConfig = response;
                 }
                 return remoteConfig;
@@ -2408,7 +2054,7 @@ class PostHogCore extends PostHogCoreStateless {
                 this.setKnownFeatureFlagDetails(newFeatureFlagDetails);
                 // Mark that we hit the /decide endpoint so we can capture this in the $feature_flag_called event
                 this.setPersistedProperty(PostHogPersistedProperty.DecideEndpointWasHit, true);
-                this.cacheSessionReplay(res);
+                this.cacheSessionReplay('decide/flags', res);
             }
             return res;
         })
@@ -2494,14 +2140,14 @@ class PostHogCore extends PostHogCoreStateless {
             this.capture('$feature_flag_called', {
                 $feature_flag: key,
                 $feature_flag_response: response,
-                $feature_flag_id: featureFlag?.metadata?.id,
-                $feature_flag_version: featureFlag?.metadata?.version,
-                $feature_flag_reason: featureFlag?.reason?.description ?? featureFlag?.reason?.code,
-                $feature_flag_bootstrapped_response: bootstrappedResponse,
-                $feature_flag_bootstrapped_payload: bootstrappedPayload,
+                ...maybeAdd('$feature_flag_id', featureFlag?.metadata?.id),
+                ...maybeAdd('$feature_flag_version', featureFlag?.metadata?.version),
+                ...maybeAdd('$feature_flag_reason', featureFlag?.reason?.description ?? featureFlag?.reason?.code),
+                ...maybeAdd('$feature_flag_bootstrapped_response', bootstrappedResponse),
+                ...maybeAdd('$feature_flag_bootstrapped_payload', bootstrappedPayload),
                 // If we haven't yet received a response from the /decide endpoint, we must have used the bootstrapped value
                 $used_bootstrap_value: !this.getPersistedProperty(PostHogPersistedProperty.DecideEndpointWasHit),
-                $feature_flag_request_id: details.requestId,
+                ...maybeAdd('$feature_flag_request_id', details.requestId),
             });
         }
         // If we have flags we either return the value (true or string) or false
@@ -2575,7 +2221,7 @@ class PostHogCore extends PostHogCoreStateless {
             .catch((e) => {
             cb?.(e, undefined);
             if (!cb) {
-                this.logMsgIfDebug(() => console.log('[PostHog] Error reloading feature flags', e));
+                this.logMsgIfDebug(() => console.log('PostHog Debug', 'Error reloading feature flags', e));
             }
         });
     }