@posthog/core 1.33.0 → 1.35.0

package/dist/logs/logs-utils.js

@@ -26,6 +26,7 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     toOtlpKeyValueList: ()=>toOtlpKeyValueList,
     getOtlpSeverityNumber: ()=>getOtlpSeverityNumber,
+    buildResourceAttributes: ()=>buildResourceAttributes,
     getOtlpSeverityText: ()=>getOtlpSeverityText,
     buildOtlpLogsPayload: ()=>buildOtlpLogsPayload,
     buildOtlpLogRecord: ()=>buildOtlpLogRecord,
@@ -142,6 +143,20 @@ function buildOtlpLogRecord(options, sdkContext) {
     if (!(0, index_js_namespaceObject.isUndefined)(options.trace_flags)) record.flags = options.trace_flags;
     return record;
 }
+function buildResourceAttributes(config, scopeName, scopeVersion) {
+    return {
+        ...config.resourceAttributes,
+        'service.name': config.serviceName || 'unknown_service',
+        ...config.environment && {
+            'deployment.environment': config.environment
+        },
+        ...config.serviceVersion && {
+            'service.version': config.serviceVersion
+        },
+        'telemetry.sdk.name': scopeName,
+        'telemetry.sdk.version': scopeVersion
+    };
+}
 function buildOtlpLogsPayload(logRecords, resourceAttributes, scopeName, scopeVersion) {
     return {
         resourceLogs: [
@@ -164,6 +179,7 @@ function buildOtlpLogsPayload(logRecords, resourceAttributes, scopeName, scopeVe
 }
 exports.buildOtlpLogRecord = __webpack_exports__.buildOtlpLogRecord;
 exports.buildOtlpLogsPayload = __webpack_exports__.buildOtlpLogsPayload;
+exports.buildResourceAttributes = __webpack_exports__.buildResourceAttributes;
 exports.getOtlpSeverityNumber = __webpack_exports__.getOtlpSeverityNumber;
 exports.getOtlpSeverityText = __webpack_exports__.getOtlpSeverityText;
 exports.toOtlpAnyValue = __webpack_exports__.toOtlpAnyValue;
@@ -171,6 +187,7 @@ exports.toOtlpKeyValueList = __webpack_exports__.toOtlpKeyValueList;
 for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "buildOtlpLogRecord",
     "buildOtlpLogsPayload",
+    "buildResourceAttributes",
     "getOtlpSeverityNumber",
     "getOtlpSeverityText",
     "toOtlpAnyValue",

package/dist/logs/logs-utils.mjs

@@ -109,6 +109,20 @@ function buildOtlpLogRecord(options, sdkContext) {
     if (!isUndefined(options.trace_flags)) record.flags = options.trace_flags;
     return record;
 }
+function buildResourceAttributes(config, scopeName, scopeVersion) {
+    return {
+        ...config.resourceAttributes,
+        'service.name': config.serviceName || 'unknown_service',
+        ...config.environment && {
+            'deployment.environment': config.environment
+        },
+        ...config.serviceVersion && {
+            'service.version': config.serviceVersion
+        },
+        'telemetry.sdk.name': scopeName,
+        'telemetry.sdk.version': scopeVersion
+    };
+}
 function buildOtlpLogsPayload(logRecords, resourceAttributes, scopeName, scopeVersion) {
     return {
         resourceLogs: [
@@ -129,4 +143,4 @@ function buildOtlpLogsPayload(logRecords, resourceAttributes, scopeName, scopeVe
         ]
     };
 }
-export { buildOtlpLogRecord, buildOtlpLogsPayload, getOtlpSeverityNumber, getOtlpSeverityText, toOtlpAnyValue, toOtlpKeyValueList };
+export { buildOtlpLogRecord, buildOtlpLogsPayload, buildResourceAttributes, getOtlpSeverityNumber, getOtlpSeverityText, toOtlpAnyValue, toOtlpKeyValueList };

package/dist/logs/types.d.ts

@@ -1,4 +1,4 @@
-export type { LogSeverityLevel, OtlpSeverityText, OtlpSeverityEntry, LogAttributeValue, LogAttributes, CaptureLogOptions, OtlpAnyValue, OtlpKeyValue, OtlpLogRecord, OtlpLogsPayload, } from '@posthog/types';
+export type { LogSeverityLevel, OtlpSeverityText, OtlpSeverityEntry, LogAttributeValue, LogAttributes, CaptureLogOptions, OtlpAnyValue, OtlpKeyValue, OtlpLogRecord, OtlpLogsPayload, BeforeSendLogFn, } from '@posthog/types';
 /**
  * SDK-internal context the host SDK passes to `buildOtlpLogRecord` at capture
  * time. Each SDK populates the fields that apply to it: browser fills
@@ -20,42 +20,26 @@ export interface LogSdkContext {
 }
 import type { Logger as CaptureLoggerType } from '@posthog/types';
 export type CaptureLogger = CaptureLoggerType;
-import type { LogAttributeValue, CaptureLogOptions, OtlpLogRecord } from '@posthog/types';
+import type { LogAttributeValue, OtlpLogRecord, OtlpLogsPayload, BeforeSendLogFn } from '@posthog/types';
+import type { PostHogPersistedProperty } from '../types';
+import type { SendLogsBatchOutcome } from '../posthog-core-stateless';
 export interface BufferedLogEntry {
     record: OtlpLogRecord;
 }
 /**
- * Pre-send filter. Inspect, mutate, or drop a captured record before it
- * enters the rate-cap or the queue. Return the (possibly transformed) record
- * to keep it; return `null` to drop it.
- *
- * Configure as a single fn or an array. Arrays form a left-to-right chain:
- * each fn receives the previous fn's return value. A `null` from any link
- * short-circuits the chain and drops the record.
- *
- * Runs *before* the rate cap so dropped records don't consume the
- * per-interval budget. Throwing fns are logged and skipped — the chain
- * continues with the previous return value, so a buggy filter degrades to a
- * no-op rather than crashing `captureLog()`.
- *
- * @example Redact secrets from log bodies
- * ```ts
- * logs: {
- *   beforeSend: (record) => ({
- *     ...record,
- *     body: record.body.replace(/api_key=\S+/g, 'api_key=[REDACTED]'),
- *   }),
- * }
- * ```
- *
- * @example Drop noisy debug logs in production
- * ```ts
- * logs: {
- *   beforeSend: (record) => (record.level === 'debug' ? null : record),
- * }
- * ```
+ * The minimal host surface `PostHogLogs` depends on. `PostHogCoreStateless`
+ * satisfies it structurally (mobile/node); the browser supplies an adapter
+ * backed by its own persistence and request layer.
  */
-export type BeforeSendLogFn = (record: CaptureLogOptions) => CaptureLogOptions | null;
+export interface LogsHost {
+    readonly isDisabled: boolean;
+    readonly optedOut: boolean;
+    getPersistedProperty<T>(key: PostHogPersistedProperty): T | undefined;
+    setPersistedProperty<T>(key: PostHogPersistedProperty, value: T | null): void;
+    _sendLogsBatch(payload: OtlpLogsPayload): Promise<SendLogsBatchOutcome>;
+    getLibraryId(): string;
+    getLibraryVersion(): string;
+}
 /**
  * Configuration for the logs feature on `new PostHog(key, { logs: ... })`.
  * All fields are optional; per-SDK defaults apply (mobile vs browser tune
@@ -65,7 +49,7 @@ export interface PostHogLogsConfig {
     /**
      * Service name attached to every record as the OTLP `service.name`
      * resource attribute. Used by the Logs UI for filtering / grouping.
-     * Default: `'unknown_service'`.
+     * Defaults to `'unknown_service'` when unset.
      */
     serviceName?: string;
     /**
@@ -94,11 +78,11 @@ export interface PostHogLogsConfig {
      */
     flushIntervalMs?: number;
     /**
-     * Max records held in memory before the queue evicts the oldest on push
-     * (FIFO). Bounds memory footprint and on-disk-queue size. When the buffer
-     * hits this size, an immediate flush is triggered to reclaim space; if
-     * the flush hasn't completed before the next capture, the oldest record
-     * is shifted out. Default: 100.
+     * Number of buffered records that triggers an immediate flush. Records also
+     * flush on the periodic interval and on `shutdown()`. The queue can grow past
+     * this while an async flush is in flight (e.g. during a synchronous burst); a
+     * separate, larger memory backstop evicts the oldest only once the queue
+     * exceeds the per-interval rate cap. Default: 100.
      */
     maxBufferSize?: number;
     /**
@@ -148,6 +132,7 @@ export interface PostHogLogsConfig {
 }
 export interface ResolvedPostHogLogsConfig extends Omit<PostHogLogsConfig, 'rateCap'> {
     maxBufferSize: number;
+    maxQueueSize?: number;
     flushIntervalMs: number;
     maxBatchRecordsPerPost: number;
     rateCapWindowMs: number;

package/dist/logs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/logs/types.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAA;AAEvB;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,YAAY,GAAG,YAAY,CAAA;IACtC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC9B;AAKD,OAAO,KAAK,EAAE,MAAM,IAAI,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACjE,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAA;AAE7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEzF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,iBAAiB,KAAK,iBAAiB,GAAG,IAAI,CAAA;AAErF;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IAEtD;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAE/B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,OAAO,CAAC,EAAE;QACR;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB;;;WAGG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;IAED;;;OAGG;IACH,UAAU,CAAC,EAAE,eAAe,GAAG,eAAe,EAAE,CAAA;CACjD;AAKD,MAAM,WAAW,yBAA0B,SAAQ,IAAI,CAAC,iBAAiB,EAAE,SAAS,CAAC;IACnF,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;IACvB,sBAAsB,EAAE,MAAM,CAAA;IAC9B,eAAe,EAAE,MAAM,CAAA;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,uBAAuB,EAAE,MAAM,CAAA;IAC/B,wBAAwB,EAAE,MAAM,CAAA;CACjC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/logs/types.ts"],"names":[],"mappings":"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"}

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
      *

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);

package/dist/posthog-core.mjs

@@ -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);

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