@posthog/core 1.32.5 → 1.34.0

package/dist/featureFlagUtils.d.ts

@@ -12,12 +12,6 @@ export declare const getFlagValuesFromFlags: (flags: PostHogFlagsResponse["flags
  * @returns The payloads
  */
 export declare const getPayloadsFromFlags: (flags: PostHogFlagsResponse["flags"]) => PostHogFlagsResponse["featureFlagPayloads"];
-/**
- * Get the flag details from the legacy v1 flags and payloads. As such, it will lack the reason, id, version, and description.
- * @param flagsResponse - The flags response
- * @returns The flag details
- */
-export declare const getFlagDetailsFromFlagsAndPayloads: (flagsResponse: PostHogFeatureFlagsResponse) => PostHogFlagsResponse["flags"];
 export declare const getFeatureFlagValue: (detail: FeatureFlagDetail | undefined) => FeatureFlagValue | undefined;
 export declare const parsePayload: (response: any) => any;
 /**

package/dist/featureFlagUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"featureFlagUtils.d.ts","sourceRoot":"","sources":["../src/featureFlagUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAEhB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EAEtB,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,SAAS,CAAA;AAEhB,eAAO,MAAM,sBAAsB,GACjC,eACI,mBAAmB,CAAC,sBAAsB,EAAE,OAAO,CAAC,GACpD,mBAAmB,CAAC,sBAAsB,EAAE,cAAc,GAAG,qBAAqB,CAAC,KACtF,2BAgCF,CAAA;AAqBD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,oBAAoB,CAAC,OAAO,CAAC,KAAG,oBAAoB,CAAC,cAAc,CAMhH,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,oBAAoB,CAAC,OAAO,CAAC,KACnC,oBAAoB,CAAC,qBAAqB,CAa5C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,kCAAkC,GAC7C,eAAe,2BAA2B,KACzC,oBAAoB,CAAC,OAAO,CAoB9B,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,QAAQ,iBAAiB,GAAG,SAAS,KAAG,gBAAgB,GAAG,SAE9F,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,UAAU,GAAG,KAAG,GAU5C,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,uCAAuC,GAClD,cAAc,sBAAsB,CAAC,cAAc,CAAC,EACpD,qBAAqB,sBAAsB,CAAC,qBAAqB,CAAC,KACjE,2BAaF,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,MAAM,iBAAiB,EAAE,OAAO,gBAAgB,KAAG,iBAMlF,CAAA;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAEpE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAE/E"}
+{"version":3,"file":"featureFlagUtils.d.ts","sourceRoot":"","sources":["../src/featureFlagUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAEhB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EAEtB,mBAAmB,EACnB,2BAA2B,EAC5B,MAAM,SAAS,CAAA;AAEhB,eAAO,MAAM,sBAAsB,GACjC,eACI,mBAAmB,CAAC,sBAAsB,EAAE,OAAO,CAAC,GACpD,mBAAmB,CAAC,sBAAsB,EAAE,cAAc,GAAG,qBAAqB,CAAC,KACtF,2BAgCF,CAAA;AAqBD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,oBAAoB,CAAC,OAAO,CAAC,KAAG,oBAAoB,CAAC,cAAc,CAMhH,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC/B,OAAO,oBAAoB,CAAC,OAAO,CAAC,KACnC,oBAAoB,CAAC,qBAAqB,CAa5C,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,QAAQ,iBAAiB,GAAG,SAAS,KAAG,gBAAgB,GAAG,SAE9F,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,UAAU,GAAG,KAAG,GAU5C,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,uCAAuC,GAClD,cAAc,sBAAsB,CAAC,cAAc,CAAC,EACpD,qBAAqB,sBAAsB,CAAC,qBAAqB,CAAC,KACjE,2BAaF,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,MAAM,iBAAiB,EAAE,OAAO,gBAAgB,KAAG,iBAMlF,CAAA;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAEpE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAE/E"}

package/dist/featureFlagUtils.js

@@ -27,7 +27,6 @@ __webpack_require__.d(__webpack_exports__, {
     createFlagsResponseFromFlagsAndPayloads: ()=>createFlagsResponseFromFlagsAndPayloads,
     getEnabledFromValue: ()=>getEnabledFromValue,
     getFeatureFlagValue: ()=>getFeatureFlagValue,
-    getFlagDetailsFromFlagsAndPayloads: ()=>getFlagDetailsFromFlagsAndPayloads,
     getFlagValuesFromFlags: ()=>getFlagValuesFromFlags,
     getPayloadsFromFlags: ()=>getPayloadsFromFlags,
     getVariantFromValue: ()=>getVariantFromValue,
@@ -94,25 +93,6 @@ const getPayloadsFromFlags = (flags)=>{
         ];
     }));
 };
-const getFlagDetailsFromFlagsAndPayloads = (flagsResponse)=>{
-    const flags = flagsResponse.featureFlags ?? {};
-    const payloads = flagsResponse.featureFlagPayloads ?? {};
-    return Object.fromEntries(Object.entries(flags).map(([key, value])=>[
-            key,
-            {
-                key: key,
-                enabled: 'string' == typeof value ? true : value,
-                variant: 'string' == typeof value ? value : void 0,
-                reason: void 0,
-                metadata: {
-                    id: void 0,
-                    version: void 0,
-                    payload: payloads?.[key] ? JSON.stringify(payloads[key]) : void 0,
-                    description: void 0
-                }
-            }
-        ]));
-};
 const getFeatureFlagValue = (detail)=>void 0 === detail ? void 0 : detail.variant ?? detail.enabled;
 const parsePayload = (response)=>{
     if ('string' != typeof response) return response;
@@ -150,7 +130,6 @@ function getVariantFromValue(value) {
 exports.createFlagsResponseFromFlagsAndPayloads = __webpack_exports__.createFlagsResponseFromFlagsAndPayloads;
 exports.getEnabledFromValue = __webpack_exports__.getEnabledFromValue;
 exports.getFeatureFlagValue = __webpack_exports__.getFeatureFlagValue;
-exports.getFlagDetailsFromFlagsAndPayloads = __webpack_exports__.getFlagDetailsFromFlagsAndPayloads;
 exports.getFlagValuesFromFlags = __webpack_exports__.getFlagValuesFromFlags;
 exports.getPayloadsFromFlags = __webpack_exports__.getPayloadsFromFlags;
 exports.getVariantFromValue = __webpack_exports__.getVariantFromValue;
@@ -161,7 +140,6 @@ for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "createFlagsResponseFromFlagsAndPayloads",
     "getEnabledFromValue",
     "getFeatureFlagValue",
-    "getFlagDetailsFromFlagsAndPayloads",
     "getFlagValuesFromFlags",
     "getPayloadsFromFlags",
     "getVariantFromValue",

package/dist/featureFlagUtils.mjs

@@ -57,25 +57,6 @@ const getPayloadsFromFlags = (flags)=>{
         ];
     }));
 };
-const getFlagDetailsFromFlagsAndPayloads = (flagsResponse)=>{
-    const flags = flagsResponse.featureFlags ?? {};
-    const payloads = flagsResponse.featureFlagPayloads ?? {};
-    return Object.fromEntries(Object.entries(flags).map(([key, value])=>[
-            key,
-            {
-                key: key,
-                enabled: 'string' == typeof value ? true : value,
-                variant: 'string' == typeof value ? value : void 0,
-                reason: void 0,
-                metadata: {
-                    id: void 0,
-                    version: void 0,
-                    payload: payloads?.[key] ? JSON.stringify(payloads[key]) : void 0,
-                    description: void 0
-                }
-            }
-        ]));
-};
 const getFeatureFlagValue = (detail)=>void 0 === detail ? void 0 : detail.variant ?? detail.enabled;
 const parsePayload = (response)=>{
     if ('string' != typeof response) return response;
@@ -110,4 +91,4 @@ function getEnabledFromValue(value) {
 function getVariantFromValue(value) {
     return 'string' == typeof value ? value : void 0;
 }
-export { createFlagsResponseFromFlagsAndPayloads, getEnabledFromValue, getFeatureFlagValue, getFlagDetailsFromFlagsAndPayloads, getFlagValuesFromFlags, getPayloadsFromFlags, getVariantFromValue, normalizeFlagsResponse, parsePayload, updateFlagValue };
+export { createFlagsResponseFromFlagsAndPayloads, getEnabledFromValue, getFeatureFlagValue, getFlagValuesFromFlags, getPayloadsFromFlags, getVariantFromValue, normalizeFlagsResponse, parsePayload, updateFlagValue };

package/dist/posthog-core.d.ts

@@ -9,6 +9,7 @@ interface FlagsAsyncOptions {
 }
 export declare abstract class PostHogCore extends PostHogCoreStateless {
     private sendFeatureFlagEvent;
+    private disableRemoteFeatureFlags;
     private flagCallReported;
     private _beforeSend?;
     protected _flagsResponsePromise?: Promise<PostHogFeatureFlagsResponse | undefined>;
@@ -165,6 +166,25 @@ export declare abstract class PostHogCore extends PostHogCoreStateless {
     onFeatureFlags(cb: (flags: PostHogFlagsResponse['featureFlags']) => void): () => void;
     onFeatureFlag(key: string, cb: (value: FeatureFlagValue) => void): () => void;
     overrideFeatureFlag(flags: PostHogFlagsResponse['featureFlags'] | null): Promise<void>;
+    /**
+     * Replaces (or merges into) the stored feature flags and payloads with locally supplied
+     * values, exactly as if they had been returned by the flags endpoint: the values are
+     * persisted, `getFeatureFlag()`/`getFeatureFlagPayload()` read them back, and
+     * `onFeatureFlags` listeners fire. Makes no network request.
+     *
+     * Intended for apps that evaluate flags outside the SDK (e.g. server-side local
+     * evaluation) and push the results in at runtime, typically together with the
+     * `disableRemoteFeatureFlags` option so the SDK never fetches flags itself.
+     *
+     * The values are cleared by `reset()`, so push them again after an identity change.
+     *
+     * @param flags - Flag keys mapped to their values (boolean, or a variant string)
+     * @param payloads - Optional flag keys mapped to their JSON payloads
+     * @param options - Set `merge: true` to merge with the currently stored flags instead of replacing them
+     */
+    updateFlags(flags: Record<string, FeatureFlagValue>, payloads?: Record<string, JsonType>, options?: {
+        merge?: boolean;
+    }): void;
     /**
      * Capture a caught exception manually
      *
@@ -315,6 +335,36 @@ export declare abstract class PostHogCore extends PostHogCoreStateless {
     }, userPropertiesToSetOnce?: {
         [key: string]: JsonType;
     }, reloadFeatureFlags?: boolean): void;
+    /**
+     * Removes properties from the person profile associated with the current `distinct_id`.
+     * Learn more about [identifying users](https://posthog.com/docs/product-analytics/identify)
+     *
+     * {@label Identification}
+     *
+     * @remarks
+     * Deletes the given person properties from the person profile in PostHog. This is the
+     * counterpart to {@link setPersonProperties} — instead of hand-passing `$unset` inside a
+     * `capture()` call, you can remove properties with a dedicated method.
+     * If `personProfiles` is set to `never`, this call is ignored.
+     *
+     * @example
+     * ```js
+     * // remove a single property
+     * posthog.unsetPersonProperties('plan')
+     * ```
+     *
+     * @example
+     * ```js
+     * // remove multiple properties
+     * posthog.unsetPersonProperties(['plan', 'email'])
+     * ```
+     *
+     * @public
+     *
+     * @param propertyNames - The name (or names) of the person properties to remove.
+     * @param reloadFeatureFlags - Whether to reload feature flags after removing the properties. Defaults to true.
+     */
+    unsetPersonProperties(propertyNames: string | string[], reloadFeatureFlags?: boolean): void;
     /**
      * Override processBeforeEnqueue to run before_send hooks.
      * This runs after prepareMessage, giving users full control over the final event.

package/dist/posthog-core.d.ts.map

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

package/dist/posthog-core.js

@@ -41,6 +41,7 @@ class PostHogCore extends external_posthog_core_stateless_js_namespaceObject.Pos
             featureFlagsRequestTimeoutMs
         }), this.flagCallReported = {}, this._sessionMaxLengthSeconds = 86400, this.sessionProps = {}, this._cachedPersonProperties = null;
         this.sendFeatureFlagEvent = options?.sendFeatureFlagEvent ?? true;
+        this.disableRemoteFeatureFlags = options?.disableRemoteFeatureFlags ?? false;
         this._sessionExpirationTimeSeconds = options?.sessionExpirationTimeSeconds ?? 1800;
         this._personProfiles = options?.personProfiles ?? 'identified_only';
         this._beforeSend = options?.before_send;
@@ -97,7 +98,11 @@ class PostHogCore extends external_posthog_core_stateless_js_namespaceObject.Pos
             this.clearProps();
             this._cachedPersonProperties = null;
             for (const key of Object.keys(external_types_js_namespaceObject.PostHogPersistedProperty))if (!allPropertiesToKeep.includes(external_types_js_namespaceObject.PostHogPersistedProperty[key])) this.setPersistedProperty(external_types_js_namespaceObject.PostHogPersistedProperty[key], null);
-            this.reloadFeatureFlags();
+            if (this.disableRemoteFeatureFlags && !this.disabled) {
+                if (!allPropertiesToKeep.includes(external_types_js_namespaceObject.PostHogPersistedProperty.FeatureFlagDetails)) this.setKnownFeatureFlagDetails({
+                    flags: {}
+                });
+            } else this.reloadFeatureFlags();
         });
     }
     getCommonEventProperties() {
@@ -312,6 +317,7 @@ class PostHogCore extends external_posthog_core_stateless_js_namespaceObject.Pos
         const { sendAnonDistinctId = true, fetchConfig = false, triggerOnRemoteConfig = false } = options ?? {};
         await this._initPromise;
         if (this.disabled) return;
+        if (this.disableRemoteFeatureFlags && !fetchConfig) return void this._logger.info('Feature flags are disabled (disableRemoteFeatureFlags), skipping reload.');
         if (this._flagsResponsePromise) {
             this._logger.info('Feature flags are being loaded already, queuing reload.');
             if (this._pendingFlagsRequest) this._flagsResponsePromise.then(this._pendingFlagsRequest.resolve).catch(this._pendingFlagsRequest.reject);
@@ -375,11 +381,11 @@ class PostHogCore extends external_posthog_core_stateless_js_namespaceObject.Pos
                     this.cacheSessionReplay('remote config', response);
                     let willLoadFlags = false;
                     if (false === response.hasFeatureFlags) {
-                        this.setKnownFeatureFlagDetails({
+                        if (!this.disableRemoteFeatureFlags) this.setKnownFeatureFlagDetails({
                             flags: {}
                         });
                         this._logger.warn('Remote config has no feature flags, will not load feature flags.');
-                    } else if (false !== this.preloadFeatureFlags) {
+                    } else if (false !== this.preloadFeatureFlags && !this.disableRemoteFeatureFlags) {
                         willLoadFlags = true;
                         this.flagsAsync({
                             sendAnonDistinctId: true,
@@ -410,16 +416,22 @@ class PostHogCore extends external_posthog_core_stateless_js_namespaceObject.Pos
             const deviceId = this.getPersistedProperty(external_types_js_namespaceObject.PostHogPersistedProperty.DeviceId);
             const extraProperties = {
                 $anon_distinct_id: sendAnonDistinctId ? this.getAnonymousId() : void 0,
-                $device_id: deviceId ?? void 0
+                $device_id: deviceId ?? void 0,
+                ...this.disableRemoteFeatureFlags ? {
+                    disable_flags: true
+                } : {}
             };
             const result = await super.getFlags(distinctId, groups, personProperties, groupProperties, extraProperties, fetchConfig);
-            if (!result.success) return void this.setKnownFeatureFlagDetails({
-                flags: this.getKnownFeatureFlagDetails()?.flags ?? {},
-                requestError: result.error
-            });
+            if (!result.success) {
+                if (!this.disableRemoteFeatureFlags) this.setKnownFeatureFlagDetails({
+                    flags: this.getKnownFeatureFlagDetails()?.flags ?? {},
+                    requestError: result.error
+                });
+                return;
+            }
             const res = result.response;
             if (res?.quotaLimited?.includes(external_posthog_core_stateless_js_namespaceObject.QuotaLimitedFeature.FeatureFlags)) {
-                this.setKnownFeatureFlagDetails({
+                if (!this.disableRemoteFeatureFlags) this.setKnownFeatureFlagDetails({
                     flags: this.getKnownFeatureFlagDetails()?.flags ?? {},
                     quotaLimited: res.quotaLimited
                 });
@@ -428,6 +440,11 @@ class PostHogCore extends external_posthog_core_stateless_js_namespaceObject.Pos
                 return res;
             }
             if (res?.featureFlags) {
+                if (this.disableRemoteFeatureFlags) {
+                    this.cacheSessionReplay('flags', res);
+                    this.maybeNotifyRemoteConfig(triggerOnRemoteConfig, res);
+                    return res;
+                }
                 if (this.sendFeatureFlagEvent) this.flagCallReported = {};
                 let newFeatureFlagDetails = res;
                 if (res.errorsWhileComputingFlags) {
@@ -607,7 +624,9 @@ class PostHogCore extends external_posthog_core_stateless_js_namespaceObject.Pos
             featureFlagPayloads: {},
             flags: {}
         };
-        const flags = details.flags ?? {};
+        const flags = {
+            ...details.flags ?? {}
+        };
         for(const key in overriddenFlags)if (overriddenFlags[key]) flags[key] = (0, external_featureFlagUtils_js_namespaceObject.updateFlagValue)(flags[key], overriddenFlags[key]);
         else delete flags[key];
         const result = {
@@ -630,6 +649,7 @@ class PostHogCore extends external_posthog_core_stateless_js_namespaceObject.Pos
         return !!response;
     }
     reloadFeatureFlags(options) {
+        if (this.disableRemoteFeatureFlags && !this.disabled) return void this._initPromise.then(()=>options?.cb?.(void 0, this.getFeatureFlags()));
         this.flagsAsync({
             sendAnonDistinctId: true
         }).then((res)=>{
@@ -643,6 +663,10 @@ class PostHogCore extends external_posthog_core_stateless_js_namespaceObject.Pos
         return await this.remoteConfigAsync();
     }
     async reloadFeatureFlagsAsync(sendAnonDistinctId) {
+        if (this.disableRemoteFeatureFlags && !this.disabled) {
+            await this._initPromise;
+            return this.getFeatureFlags();
+        }
         return (await this.flagsAsync({
             sendAnonDistinctId: sendAnonDistinctId
         }))?.featureFlags;
@@ -665,6 +689,51 @@ class PostHogCore extends external_posthog_core_stateless_js_namespaceObject.Pos
             return this.setPersistedProperty(external_types_js_namespaceObject.PostHogPersistedProperty.OverrideFeatureFlags, flags);
         });
     }
+    updateFlags(flags, payloads, options) {
+        this.wrap(()=>{
+            const existingDetails = options?.merge ? this.getKnownFeatureFlagDetails()?.flags : void 0;
+            const existingFlags = existingDetails ? (0, external_featureFlagUtils_js_namespaceObject.getFlagValuesFromFlags)(existingDetails) : {};
+            const existingPayloads = {};
+            for(const key in existingDetails){
+                const storedPayload = existingDetails[key].metadata?.payload;
+                if (void 0 !== storedPayload) existingPayloads[key] = (0, external_featureFlagUtils_js_namespaceObject.parsePayload)(storedPayload);
+            }
+            const finalFlags = {
+                ...existingFlags,
+                ...flags
+            };
+            const finalPayloads = {
+                ...existingPayloads,
+                ...payloads ?? {}
+            };
+            const flagDetails = {};
+            for (const [key, value] of Object.entries(finalFlags)){
+                const payload = finalPayloads[key];
+                let serializedPayload;
+                if (void 0 !== payload) try {
+                    serializedPayload = JSON.stringify(payload);
+                } catch (e) {
+                    this._logger.error(`updateFlags: could not serialize the payload for flag "${key}", dropping it.`, e);
+                }
+                flagDetails[key] = {
+                    key,
+                    enabled: (0, external_featureFlagUtils_js_namespaceObject.getEnabledFromValue)(value),
+                    variant: (0, external_featureFlagUtils_js_namespaceObject.getVariantFromValue)(value),
+                    reason: void 0,
+                    metadata: {
+                        id: void 0,
+                        version: void 0,
+                        description: void 0,
+                        payload: serializedPayload
+                    }
+                };
+            }
+            if (this.sendFeatureFlagEvent) this.flagCallReported = {};
+            this.setKnownFeatureFlagDetails({
+                flags: flagDetails
+            });
+        });
+    }
     captureException(error, additionalProperties, hint) {
         try {
             const exceptionProperties = this.getErrorPropertiesBuilder().buildFromUnknown(error, hint);
@@ -747,6 +816,26 @@ class PostHogCore extends external_posthog_core_stateless_js_namespaceObject.Pos
             this._cachedPersonProperties = hash;
         });
     }
+    unsetPersonProperties(propertyNames, reloadFeatureFlags = true) {
+        this.wrap(()=>{
+            const names = ((0, index_js_namespaceObject.isArray)(propertyNames) ? propertyNames : [
+                propertyNames
+            ]).filter((name)=>(0, index_js_namespaceObject.isString)(name) && name.length > 0);
+            if (0 === names.length) return;
+            if (!this._requirePersonProcessing('posthog.unsetPersonProperties')) return;
+            const existingProperties = this.getPersistedProperty(external_types_js_namespaceObject.PostHogPersistedProperty.PersonProperties) || {};
+            const nextProperties = {
+                ...existingProperties
+            };
+            for (const name of names)delete nextProperties[name];
+            this.setPersistedProperty(external_types_js_namespaceObject.PostHogPersistedProperty.PersonProperties, nextProperties);
+            if (reloadFeatureFlags) this.reloadFeatureFlags();
+            this.capture('$set', {
+                $unset: names
+            });
+            this._cachedPersonProperties = null;
+        });
+    }
     processBeforeEnqueue(message) {
         if (!this._beforeSend) return message;
         const timestamp = message.timestamp;

package/dist/posthog-core.mjs

@@ -2,7 +2,7 @@ import { createFlagsResponseFromFlagsAndPayloads, getEnabledFromValue, getFeatur
 import { Compression, FeatureFlagError, PostHogPersistedProperty } from "./types.mjs";
 import { PostHogCoreStateless, QuotaLimitedFeature, maybeAdd } from "./posthog-core-stateless.mjs";
 import { uuidv7 } from "./vendor/uuidv7.mjs";
-import { getPersonPropertiesHash, isEmptyObject, isNullish, isObject } from "./utils/index.mjs";
+import { getPersonPropertiesHash, isArray, isEmptyObject, isNullish, isObject, isString } from "./utils/index.mjs";
 class PostHogCore extends PostHogCoreStateless {
     constructor(apiKey, options){
         const disableGeoipOption = options?.disableGeoip ?? false;
@@ -13,6 +13,7 @@ class PostHogCore extends PostHogCoreStateless {
             featureFlagsRequestTimeoutMs
         }), this.flagCallReported = {}, this._sessionMaxLengthSeconds = 86400, this.sessionProps = {}, this._cachedPersonProperties = null;
         this.sendFeatureFlagEvent = options?.sendFeatureFlagEvent ?? true;
+        this.disableRemoteFeatureFlags = options?.disableRemoteFeatureFlags ?? false;
         this._sessionExpirationTimeSeconds = options?.sessionExpirationTimeSeconds ?? 1800;
         this._personProfiles = options?.personProfiles ?? 'identified_only';
         this._beforeSend = options?.before_send;
@@ -69,7 +70,11 @@ class PostHogCore extends PostHogCoreStateless {
             this.clearProps();
             this._cachedPersonProperties = null;
             for (const key of Object.keys(PostHogPersistedProperty))if (!allPropertiesToKeep.includes(PostHogPersistedProperty[key])) this.setPersistedProperty(PostHogPersistedProperty[key], null);
-            this.reloadFeatureFlags();
+            if (this.disableRemoteFeatureFlags && !this.disabled) {
+                if (!allPropertiesToKeep.includes(PostHogPersistedProperty.FeatureFlagDetails)) this.setKnownFeatureFlagDetails({
+                    flags: {}
+                });
+            } else this.reloadFeatureFlags();
         });
     }
     getCommonEventProperties() {
@@ -284,6 +289,7 @@ class PostHogCore extends PostHogCoreStateless {
         const { sendAnonDistinctId = true, fetchConfig = false, triggerOnRemoteConfig = false } = options ?? {};
         await this._initPromise;
         if (this.disabled) return;
+        if (this.disableRemoteFeatureFlags && !fetchConfig) return void this._logger.info('Feature flags are disabled (disableRemoteFeatureFlags), skipping reload.');
         if (this._flagsResponsePromise) {
             this._logger.info('Feature flags are being loaded already, queuing reload.');
             if (this._pendingFlagsRequest) this._flagsResponsePromise.then(this._pendingFlagsRequest.resolve).catch(this._pendingFlagsRequest.reject);
@@ -347,11 +353,11 @@ class PostHogCore extends PostHogCoreStateless {
                     this.cacheSessionReplay('remote config', response);
                     let willLoadFlags = false;
                     if (false === response.hasFeatureFlags) {
-                        this.setKnownFeatureFlagDetails({
+                        if (!this.disableRemoteFeatureFlags) this.setKnownFeatureFlagDetails({
                             flags: {}
                         });
                         this._logger.warn('Remote config has no feature flags, will not load feature flags.');
-                    } else if (false !== this.preloadFeatureFlags) {
+                    } else if (false !== this.preloadFeatureFlags && !this.disableRemoteFeatureFlags) {
                         willLoadFlags = true;
                         this.flagsAsync({
                             sendAnonDistinctId: true,
@@ -382,16 +388,22 @@ class PostHogCore extends PostHogCoreStateless {
             const deviceId = this.getPersistedProperty(PostHogPersistedProperty.DeviceId);
             const extraProperties = {
                 $anon_distinct_id: sendAnonDistinctId ? this.getAnonymousId() : void 0,
-                $device_id: deviceId ?? void 0
+                $device_id: deviceId ?? void 0,
+                ...this.disableRemoteFeatureFlags ? {
+                    disable_flags: true
+                } : {}
             };
             const result = await super.getFlags(distinctId, groups, personProperties, groupProperties, extraProperties, fetchConfig);
-            if (!result.success) return void this.setKnownFeatureFlagDetails({
-                flags: this.getKnownFeatureFlagDetails()?.flags ?? {},
-                requestError: result.error
-            });
+            if (!result.success) {
+                if (!this.disableRemoteFeatureFlags) this.setKnownFeatureFlagDetails({
+                    flags: this.getKnownFeatureFlagDetails()?.flags ?? {},
+                    requestError: result.error
+                });
+                return;
+            }
             const res = result.response;
             if (res?.quotaLimited?.includes(QuotaLimitedFeature.FeatureFlags)) {
-                this.setKnownFeatureFlagDetails({
+                if (!this.disableRemoteFeatureFlags) this.setKnownFeatureFlagDetails({
                     flags: this.getKnownFeatureFlagDetails()?.flags ?? {},
                     quotaLimited: res.quotaLimited
                 });
@@ -400,6 +412,11 @@ class PostHogCore extends PostHogCoreStateless {
                 return res;
             }
             if (res?.featureFlags) {
+                if (this.disableRemoteFeatureFlags) {
+                    this.cacheSessionReplay('flags', res);
+                    this.maybeNotifyRemoteConfig(triggerOnRemoteConfig, res);
+                    return res;
+                }
                 if (this.sendFeatureFlagEvent) this.flagCallReported = {};
                 let newFeatureFlagDetails = res;
                 if (res.errorsWhileComputingFlags) {
@@ -579,7 +596,9 @@ class PostHogCore extends PostHogCoreStateless {
             featureFlagPayloads: {},
             flags: {}
         };
-        const flags = details.flags ?? {};
+        const flags = {
+            ...details.flags ?? {}
+        };
         for(const key in overriddenFlags)if (overriddenFlags[key]) flags[key] = updateFlagValue(flags[key], overriddenFlags[key]);
         else delete flags[key];
         const result = {
@@ -602,6 +621,7 @@ class PostHogCore extends PostHogCoreStateless {
         return !!response;
     }
     reloadFeatureFlags(options) {
+        if (this.disableRemoteFeatureFlags && !this.disabled) return void this._initPromise.then(()=>options?.cb?.(void 0, this.getFeatureFlags()));
         this.flagsAsync({
             sendAnonDistinctId: true
         }).then((res)=>{
@@ -615,6 +635,10 @@ class PostHogCore extends PostHogCoreStateless {
         return await this.remoteConfigAsync();
     }
     async reloadFeatureFlagsAsync(sendAnonDistinctId) {
+        if (this.disableRemoteFeatureFlags && !this.disabled) {
+            await this._initPromise;
+            return this.getFeatureFlags();
+        }
         return (await this.flagsAsync({
             sendAnonDistinctId: sendAnonDistinctId
         }))?.featureFlags;
@@ -637,6 +661,51 @@ class PostHogCore extends PostHogCoreStateless {
             return this.setPersistedProperty(PostHogPersistedProperty.OverrideFeatureFlags, flags);
         });
     }
+    updateFlags(flags, payloads, options) {
+        this.wrap(()=>{
+            const existingDetails = options?.merge ? this.getKnownFeatureFlagDetails()?.flags : void 0;
+            const existingFlags = existingDetails ? getFlagValuesFromFlags(existingDetails) : {};
+            const existingPayloads = {};
+            for(const key in existingDetails){
+                const storedPayload = existingDetails[key].metadata?.payload;
+                if (void 0 !== storedPayload) existingPayloads[key] = parsePayload(storedPayload);
+            }
+            const finalFlags = {
+                ...existingFlags,
+                ...flags
+            };
+            const finalPayloads = {
+                ...existingPayloads,
+                ...payloads ?? {}
+            };
+            const flagDetails = {};
+            for (const [key, value] of Object.entries(finalFlags)){
+                const payload = finalPayloads[key];
+                let serializedPayload;
+                if (void 0 !== payload) try {
+                    serializedPayload = JSON.stringify(payload);
+                } catch (e) {
+                    this._logger.error(`updateFlags: could not serialize the payload for flag "${key}", dropping it.`, e);
+                }
+                flagDetails[key] = {
+                    key,
+                    enabled: getEnabledFromValue(value),
+                    variant: getVariantFromValue(value),
+                    reason: void 0,
+                    metadata: {
+                        id: void 0,
+                        version: void 0,
+                        description: void 0,
+                        payload: serializedPayload
+                    }
+                };
+            }
+            if (this.sendFeatureFlagEvent) this.flagCallReported = {};
+            this.setKnownFeatureFlagDetails({
+                flags: flagDetails
+            });
+        });
+    }
     captureException(error, additionalProperties, hint) {
         try {
             const exceptionProperties = this.getErrorPropertiesBuilder().buildFromUnknown(error, hint);
@@ -719,6 +788,26 @@ class PostHogCore extends PostHogCoreStateless {
             this._cachedPersonProperties = hash;
         });
     }
+    unsetPersonProperties(propertyNames, reloadFeatureFlags = true) {
+        this.wrap(()=>{
+            const names = (isArray(propertyNames) ? propertyNames : [
+                propertyNames
+            ]).filter((name)=>isString(name) && name.length > 0);
+            if (0 === names.length) return;
+            if (!this._requirePersonProcessing('posthog.unsetPersonProperties')) return;
+            const existingProperties = this.getPersistedProperty(PostHogPersistedProperty.PersonProperties) || {};
+            const nextProperties = {
+                ...existingProperties
+            };
+            for (const name of names)delete nextProperties[name];
+            this.setPersistedProperty(PostHogPersistedProperty.PersonProperties, nextProperties);
+            if (reloadFeatureFlags) this.reloadFeatureFlags();
+            this.capture('$set', {
+                $unset: names
+            });
+            this._cachedPersonProperties = null;
+        });
+    }
     processBeforeEnqueue(message) {
         if (!this._beforeSend) return message;
         const timestamp = message.timestamp;

package/dist/types.d.ts

@@ -53,6 +53,25 @@ export type PostHogCoreOptions = {
      * @default true
      */
     preloadFeatureFlags?: boolean;
+    /**
+     * Advanced: whether to disable fetching and evaluating feature flags from PostHog entirely.
+     *
+     * When set to true, `reloadFeatureFlags()` and the reloads triggered by `identify()`,
+     * `group()`, `setPersonPropertiesForFlags()` and `reset()` become no-ops, and any request
+     * to the flags endpoint that still goes out (e.g. to fetch remote config or surveys)
+     * carries `disable_flags: true` so the server skips flag evaluation. Flag values must be
+     * supplied via the `bootstrap` option or `updateFlags()` instead; `getFeatureFlag()` and
+     * related methods keep working against those values. Until `updateFlags()` runs, reads
+     * return their not-loaded defaults, so use `bootstrap` for any flags needed at startup.
+     * Equivalent to the web SDK's `advanced_disable_feature_flags`.
+     *
+     * Note: surveys gated on feature flags will not evaluate unless the survey targeting
+     * flags are also provided via `updateFlags()`. This option cannot be toggled at runtime.
+     * `posthog-node` inherits this option but does not implement it (no-op).
+     *
+     * @default false
+     */
+    disableRemoteFeatureFlags?: boolean;
     /**
      * Whether to load remote config when initialized or not
      * Experimental support
@@ -744,6 +763,15 @@ export declare const knownUnsafeEditableEvent: readonly ["$snapshot", "$pageview
  * Some features of PostHog rely on receiving 100% of these events
  */
 export type KnownUnsafeEditableEvent = (typeof knownUnsafeEditableEvent)[number];
+export declare const knownUnsafeEditableEventProperty: readonly ["token"];
+/**
+ * These event properties can be edited by the `before_send` function
+ * but are required for the event to be ingested. For example `token` carries
+ * the project api_key, and ingest rejects any event that arrives without it.
+ *
+ * If a `before_send` function removes one of these, the event is dropped.
+ */
+export type KnownUnsafeEditableEventProperty = (typeof knownUnsafeEditableEventProperty)[number];
 /**
  * Represents an event before it's sent to PostHog.
  * This is the interface exposed to the `before_send` hook, matching the web SDK's `CaptureResult`.