@posthog/core 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (126) hide show
  1. package/dist/error-tracking/chunk-ids.js +1 -1
  2. package/dist/error-tracking/chunk-ids.mjs +1 -1
  3. package/dist/error-tracking/coercers/error-event-coercer.js +4 -5
  4. package/dist/error-tracking/coercers/error-event-coercer.mjs +4 -5
  5. package/dist/error-tracking/coercers/event-coercer.js +1 -2
  6. package/dist/error-tracking/coercers/event-coercer.mjs +1 -2
  7. package/dist/error-tracking/coercers/object-coercer.js +1 -2
  8. package/dist/error-tracking/coercers/object-coercer.mjs +1 -2
  9. package/dist/error-tracking/coercers/primitive-coercer.js +1 -2
  10. package/dist/error-tracking/coercers/primitive-coercer.mjs +1 -2
  11. package/dist/error-tracking/coercers/promise-rejection-event.js +4 -5
  12. package/dist/error-tracking/coercers/promise-rejection-event.mjs +4 -5
  13. package/dist/error-tracking/coercers/string-coercer.js +3 -4
  14. package/dist/error-tracking/coercers/string-coercer.mjs +3 -4
  15. package/dist/error-tracking/coercers/utils.js +2 -4
  16. package/dist/error-tracking/coercers/utils.mjs +2 -4
  17. package/dist/error-tracking/error-properties-builder.js +11 -15
  18. package/dist/error-tracking/error-properties-builder.mjs +11 -15
  19. package/dist/error-tracking/parsers/index.js +2 -4
  20. package/dist/error-tracking/parsers/index.mjs +2 -4
  21. package/dist/error-tracking/parsers/node.js +3 -5
  22. package/dist/error-tracking/parsers/node.mjs +3 -5
  23. package/dist/error-tracking/utils.js +4 -4
  24. package/dist/error-tracking/utils.mjs +4 -4
  25. package/dist/eventemitter.js +4 -4
  26. package/dist/eventemitter.mjs +4 -4
  27. package/dist/featureFlagUtils.js +20 -45
  28. package/dist/featureFlagUtils.mjs +20 -45
  29. package/dist/gzip.js +1 -2
  30. package/dist/gzip.mjs +1 -2
  31. package/dist/index.d.ts +4 -366
  32. package/dist/index.d.ts.map +1 -1
  33. package/dist/index.js +54 -1225
  34. package/dist/index.mjs +5 -1190
  35. package/dist/posthog-core-stateless.d.ts +204 -0
  36. package/dist/posthog-core-stateless.d.ts.map +1 -0
  37. package/dist/posthog-core-stateless.js +675 -0
  38. package/dist/posthog-core-stateless.mjs +632 -0
  39. package/dist/posthog-core.d.ts +171 -0
  40. package/dist/posthog-core.d.ts.map +1 -0
  41. package/dist/posthog-core.js +554 -0
  42. package/dist/posthog-core.mjs +520 -0
  43. package/dist/testing/PostHogCoreTestClient.d.ts +2 -1
  44. package/dist/testing/PostHogCoreTestClient.d.ts.map +1 -1
  45. package/dist/testing/PostHogCoreTestClient.js +9 -11
  46. package/dist/testing/PostHogCoreTestClient.mjs +8 -10
  47. package/dist/testing/test-utils.js +1 -1
  48. package/dist/testing/test-utils.mjs +1 -1
  49. package/dist/utils/bucketed-rate-limiter.js +8 -12
  50. package/dist/utils/bucketed-rate-limiter.mjs +8 -12
  51. package/dist/utils/index.js +3 -3
  52. package/dist/utils/index.mjs +3 -3
  53. package/dist/utils/type-utils.js +1 -1
  54. package/dist/utils/type-utils.mjs +1 -1
  55. package/dist/vendor/uuidv7.js +12 -16
  56. package/dist/vendor/uuidv7.mjs +12 -16
  57. package/package.json +3 -2
  58. package/src/__tests__/featureFlagUtils.spec.ts +427 -0
  59. package/src/__tests__/gzip.spec.ts +69 -0
  60. package/src/__tests__/posthog.ai.spec.ts +110 -0
  61. package/src/__tests__/posthog.capture.spec.ts +91 -0
  62. package/src/__tests__/posthog.core.spec.ts +135 -0
  63. package/src/__tests__/posthog.debug.spec.ts +36 -0
  64. package/src/__tests__/posthog.enqueue.spec.ts +93 -0
  65. package/src/__tests__/posthog.featureflags.spec.ts +1106 -0
  66. package/src/__tests__/posthog.featureflags.v1.spec.ts +922 -0
  67. package/src/__tests__/posthog.flush.spec.ts +237 -0
  68. package/src/__tests__/posthog.gdpr.spec.ts +50 -0
  69. package/src/__tests__/posthog.groups.spec.ts +96 -0
  70. package/src/__tests__/posthog.identify.spec.ts +194 -0
  71. package/src/__tests__/posthog.init.spec.ts +110 -0
  72. package/src/__tests__/posthog.listeners.spec.ts +51 -0
  73. package/src/__tests__/posthog.register.spec.ts +47 -0
  74. package/src/__tests__/posthog.reset.spec.ts +76 -0
  75. package/src/__tests__/posthog.sessions.spec.ts +63 -0
  76. package/src/__tests__/posthog.setProperties.spec.ts +102 -0
  77. package/src/__tests__/posthog.shutdown.spec.ts +88 -0
  78. package/src/__tests__/utils.spec.ts +36 -0
  79. package/src/error-tracking/chunk-ids.ts +58 -0
  80. package/src/error-tracking/coercers/dom-exception-coercer.ts +38 -0
  81. package/src/error-tracking/coercers/error-coercer.ts +36 -0
  82. package/src/error-tracking/coercers/error-event-coercer.ts +24 -0
  83. package/src/error-tracking/coercers/event-coercer.ts +19 -0
  84. package/src/error-tracking/coercers/index.ts +8 -0
  85. package/src/error-tracking/coercers/object-coercer.ts +76 -0
  86. package/src/error-tracking/coercers/primitive-coercer.ts +19 -0
  87. package/src/error-tracking/coercers/promise-rejection-event.spec.ts +77 -0
  88. package/src/error-tracking/coercers/promise-rejection-event.ts +53 -0
  89. package/src/error-tracking/coercers/string-coercer.spec.ts +26 -0
  90. package/src/error-tracking/coercers/string-coercer.ts +31 -0
  91. package/src/error-tracking/coercers/utils.ts +33 -0
  92. package/src/error-tracking/error-properties-builder.coerce.spec.ts +202 -0
  93. package/src/error-tracking/error-properties-builder.parse.spec.ts +30 -0
  94. package/src/error-tracking/error-properties-builder.ts +169 -0
  95. package/src/error-tracking/index.ts +5 -0
  96. package/src/error-tracking/parsers/base.ts +29 -0
  97. package/src/error-tracking/parsers/chrome.ts +53 -0
  98. package/src/error-tracking/parsers/gecko.ts +38 -0
  99. package/src/error-tracking/parsers/index.ts +104 -0
  100. package/src/error-tracking/parsers/node.ts +111 -0
  101. package/src/error-tracking/parsers/opera.ts +18 -0
  102. package/src/error-tracking/parsers/react-native.ts +0 -0
  103. package/src/error-tracking/parsers/safari.ts +33 -0
  104. package/src/error-tracking/parsers/winjs.ts +12 -0
  105. package/src/error-tracking/types.ts +107 -0
  106. package/src/error-tracking/utils.ts +39 -0
  107. package/src/eventemitter.ts +27 -0
  108. package/src/featureFlagUtils.ts +192 -0
  109. package/src/gzip.ts +29 -0
  110. package/src/index.ts +8 -0
  111. package/src/posthog-core-stateless.ts +1226 -0
  112. package/src/posthog-core.ts +958 -0
  113. package/src/testing/PostHogCoreTestClient.ts +91 -0
  114. package/src/testing/index.ts +2 -0
  115. package/src/testing/test-utils.ts +47 -0
  116. package/src/types.ts +544 -0
  117. package/src/utils/bucketed-rate-limiter.spec.ts +33 -0
  118. package/src/utils/bucketed-rate-limiter.ts +85 -0
  119. package/src/utils/index.ts +98 -0
  120. package/src/utils/number-utils.spec.ts +89 -0
  121. package/src/utils/number-utils.ts +30 -0
  122. package/src/utils/promise-queue.spec.ts +55 -0
  123. package/src/utils/promise-queue.ts +30 -0
  124. package/src/utils/string-utils.ts +23 -0
  125. package/src/utils/type-utils.ts +134 -0
  126. package/src/vendor/uuidv7.ts +479 -0
@@ -0,0 +1,520 @@
1
+ import { createFlagsResponseFromFlagsAndPayloads, getFeatureFlagValue, getFlagValuesFromFlags, getPayloadsFromFlags, normalizeFlagsResponse, updateFlagValue } from "./featureFlagUtils.mjs";
2
+ import { Compression, PostHogPersistedProperty } from "./types.mjs";
3
+ import { PostHogCoreStateless, QuotaLimitedFeature, maybeAdd } from "./posthog-core-stateless.mjs";
4
+ import { uuidv7 } from "./vendor/uuidv7.mjs";
5
+ import { isPlainError } from "./utils/index.mjs";
6
+ class PostHogCore extends PostHogCoreStateless {
7
+ constructor(apiKey, options){
8
+ const disableGeoipOption = options?.disableGeoip ?? false;
9
+ const featureFlagsRequestTimeoutMs = options?.featureFlagsRequestTimeoutMs ?? 10000;
10
+ super(apiKey, {
11
+ ...options,
12
+ disableGeoip: disableGeoipOption,
13
+ featureFlagsRequestTimeoutMs
14
+ }), this.flagCallReported = {}, this._sessionMaxLengthSeconds = 86400, this.sessionProps = {};
15
+ this.sendFeatureFlagEvent = options?.sendFeatureFlagEvent ?? true;
16
+ this._sessionExpirationTimeSeconds = options?.sessionExpirationTimeSeconds ?? 1800;
17
+ }
18
+ setupBootstrap(options) {
19
+ const bootstrap = options?.bootstrap;
20
+ if (!bootstrap) return;
21
+ if (bootstrap.distinctId) if (bootstrap.isIdentifiedId) {
22
+ const distinctId = this.getPersistedProperty(PostHogPersistedProperty.DistinctId);
23
+ if (!distinctId) this.setPersistedProperty(PostHogPersistedProperty.DistinctId, bootstrap.distinctId);
24
+ } else {
25
+ const anonymousId = this.getPersistedProperty(PostHogPersistedProperty.AnonymousId);
26
+ if (!anonymousId) this.setPersistedProperty(PostHogPersistedProperty.AnonymousId, bootstrap.distinctId);
27
+ }
28
+ const bootstrapFeatureFlags = bootstrap.featureFlags;
29
+ const bootstrapFeatureFlagPayloads = bootstrap.featureFlagPayloads ?? {};
30
+ if (bootstrapFeatureFlags && Object.keys(bootstrapFeatureFlags).length) {
31
+ const normalizedBootstrapFeatureFlagDetails = createFlagsResponseFromFlagsAndPayloads(bootstrapFeatureFlags, bootstrapFeatureFlagPayloads);
32
+ if (Object.keys(normalizedBootstrapFeatureFlagDetails.flags).length > 0) {
33
+ this.setBootstrappedFeatureFlagDetails(normalizedBootstrapFeatureFlagDetails);
34
+ const currentFeatureFlagDetails = this.getKnownFeatureFlagDetails() || {
35
+ flags: {},
36
+ requestId: void 0
37
+ };
38
+ const newFeatureFlagDetails = {
39
+ flags: {
40
+ ...normalizedBootstrapFeatureFlagDetails.flags,
41
+ ...currentFeatureFlagDetails.flags
42
+ },
43
+ requestId: normalizedBootstrapFeatureFlagDetails.requestId
44
+ };
45
+ this.setKnownFeatureFlagDetails(newFeatureFlagDetails);
46
+ }
47
+ }
48
+ }
49
+ clearProps() {
50
+ this.props = void 0;
51
+ this.sessionProps = {};
52
+ this.flagCallReported = {};
53
+ }
54
+ on(event, cb) {
55
+ return this._events.on(event, cb);
56
+ }
57
+ reset(propertiesToKeep) {
58
+ this.wrap(()=>{
59
+ const allPropertiesToKeep = [
60
+ PostHogPersistedProperty.Queue,
61
+ ...propertiesToKeep || []
62
+ ];
63
+ this.clearProps();
64
+ for (const key of Object.keys(PostHogPersistedProperty))if (!allPropertiesToKeep.includes(PostHogPersistedProperty[key])) this.setPersistedProperty(PostHogPersistedProperty[key], null);
65
+ this.reloadFeatureFlags();
66
+ });
67
+ }
68
+ getCommonEventProperties() {
69
+ const featureFlags = this.getFeatureFlags();
70
+ const featureVariantProperties = {};
71
+ if (featureFlags) for (const [feature, variant] of Object.entries(featureFlags))featureVariantProperties[`$feature/${feature}`] = variant;
72
+ return {
73
+ ...maybeAdd('$active_feature_flags', featureFlags ? Object.keys(featureFlags) : void 0),
74
+ ...featureVariantProperties,
75
+ ...super.getCommonEventProperties()
76
+ };
77
+ }
78
+ enrichProperties(properties) {
79
+ return {
80
+ ...this.props,
81
+ ...this.sessionProps,
82
+ ...properties || {},
83
+ ...this.getCommonEventProperties(),
84
+ $session_id: this.getSessionId()
85
+ };
86
+ }
87
+ getSessionId() {
88
+ if (!this._isInitialized) return '';
89
+ let sessionId = this.getPersistedProperty(PostHogPersistedProperty.SessionId);
90
+ const sessionLastTimestamp = this.getPersistedProperty(PostHogPersistedProperty.SessionLastTimestamp) || 0;
91
+ const sessionStartTimestamp = this.getPersistedProperty(PostHogPersistedProperty.SessionStartTimestamp) || 0;
92
+ const now = Date.now();
93
+ const sessionLastDif = now - sessionLastTimestamp;
94
+ const sessionStartDif = now - sessionStartTimestamp;
95
+ if (!sessionId || sessionLastDif > 1000 * this._sessionExpirationTimeSeconds || sessionStartDif > 1000 * this._sessionMaxLengthSeconds) {
96
+ sessionId = uuidv7();
97
+ this.setPersistedProperty(PostHogPersistedProperty.SessionId, sessionId);
98
+ this.setPersistedProperty(PostHogPersistedProperty.SessionStartTimestamp, now);
99
+ }
100
+ this.setPersistedProperty(PostHogPersistedProperty.SessionLastTimestamp, now);
101
+ return sessionId;
102
+ }
103
+ resetSessionId() {
104
+ this.wrap(()=>{
105
+ this.setPersistedProperty(PostHogPersistedProperty.SessionId, null);
106
+ this.setPersistedProperty(PostHogPersistedProperty.SessionLastTimestamp, null);
107
+ this.setPersistedProperty(PostHogPersistedProperty.SessionStartTimestamp, null);
108
+ });
109
+ }
110
+ getAnonymousId() {
111
+ if (!this._isInitialized) return '';
112
+ let anonId = this.getPersistedProperty(PostHogPersistedProperty.AnonymousId);
113
+ if (!anonId) {
114
+ anonId = uuidv7();
115
+ this.setPersistedProperty(PostHogPersistedProperty.AnonymousId, anonId);
116
+ }
117
+ return anonId;
118
+ }
119
+ getDistinctId() {
120
+ if (!this._isInitialized) return '';
121
+ return this.getPersistedProperty(PostHogPersistedProperty.DistinctId) || this.getAnonymousId();
122
+ }
123
+ registerForSession(properties) {
124
+ this.sessionProps = {
125
+ ...this.sessionProps,
126
+ ...properties
127
+ };
128
+ }
129
+ unregisterForSession(property) {
130
+ delete this.sessionProps[property];
131
+ }
132
+ identify(distinctId, properties, options) {
133
+ this.wrap(()=>{
134
+ const previousDistinctId = this.getDistinctId();
135
+ distinctId = distinctId || previousDistinctId;
136
+ if (properties?.$groups) this.groups(properties.$groups);
137
+ const userPropsOnce = properties?.$set_once;
138
+ delete properties?.$set_once;
139
+ const userProps = properties?.$set || properties;
140
+ const allProperties = this.enrichProperties({
141
+ $anon_distinct_id: this.getAnonymousId(),
142
+ ...maybeAdd('$set', userProps),
143
+ ...maybeAdd('$set_once', userPropsOnce)
144
+ });
145
+ if (distinctId !== previousDistinctId) {
146
+ this.setPersistedProperty(PostHogPersistedProperty.AnonymousId, previousDistinctId);
147
+ this.setPersistedProperty(PostHogPersistedProperty.DistinctId, distinctId);
148
+ this.reloadFeatureFlags();
149
+ }
150
+ super.identifyStateless(distinctId, allProperties, options);
151
+ });
152
+ }
153
+ capture(event, properties, options) {
154
+ this.wrap(()=>{
155
+ const distinctId = this.getDistinctId();
156
+ if (properties?.$groups) this.groups(properties.$groups);
157
+ const allProperties = this.enrichProperties(properties);
158
+ super.captureStateless(distinctId, event, allProperties, options);
159
+ });
160
+ }
161
+ alias(alias) {
162
+ this.wrap(()=>{
163
+ const distinctId = this.getDistinctId();
164
+ const allProperties = this.enrichProperties({});
165
+ super.aliasStateless(alias, distinctId, allProperties);
166
+ });
167
+ }
168
+ autocapture(eventType, elements, properties = {}, options) {
169
+ this.wrap(()=>{
170
+ const distinctId = this.getDistinctId();
171
+ const payload = {
172
+ distinct_id: distinctId,
173
+ event: '$autocapture',
174
+ properties: {
175
+ ...this.enrichProperties(properties),
176
+ $event_type: eventType,
177
+ $elements: elements
178
+ }
179
+ };
180
+ this.enqueue('autocapture', payload, options);
181
+ });
182
+ }
183
+ groups(groups) {
184
+ this.wrap(()=>{
185
+ const existingGroups = this.props.$groups || {};
186
+ this.register({
187
+ $groups: {
188
+ ...existingGroups,
189
+ ...groups
190
+ }
191
+ });
192
+ if (Object.keys(groups).find((type)=>existingGroups[type] !== groups[type])) this.reloadFeatureFlags();
193
+ });
194
+ }
195
+ group(groupType, groupKey, groupProperties, options) {
196
+ this.wrap(()=>{
197
+ this.groups({
198
+ [groupType]: groupKey
199
+ });
200
+ if (groupProperties) this.groupIdentify(groupType, groupKey, groupProperties, options);
201
+ });
202
+ }
203
+ groupIdentify(groupType, groupKey, groupProperties, options) {
204
+ this.wrap(()=>{
205
+ const distinctId = this.getDistinctId();
206
+ const eventProperties = this.enrichProperties({});
207
+ super.groupIdentifyStateless(groupType, groupKey, groupProperties, options, distinctId, eventProperties);
208
+ });
209
+ }
210
+ setPersonPropertiesForFlags(properties) {
211
+ this.wrap(()=>{
212
+ const existingProperties = this.getPersistedProperty(PostHogPersistedProperty.PersonProperties) || {};
213
+ this.setPersistedProperty(PostHogPersistedProperty.PersonProperties, {
214
+ ...existingProperties,
215
+ ...properties
216
+ });
217
+ });
218
+ }
219
+ resetPersonPropertiesForFlags() {
220
+ this.wrap(()=>{
221
+ this.setPersistedProperty(PostHogPersistedProperty.PersonProperties, null);
222
+ });
223
+ }
224
+ setGroupPropertiesForFlags(properties) {
225
+ this.wrap(()=>{
226
+ const existingProperties = this.getPersistedProperty(PostHogPersistedProperty.GroupProperties) || {};
227
+ if (0 !== Object.keys(existingProperties).length) Object.keys(existingProperties).forEach((groupType)=>{
228
+ existingProperties[groupType] = {
229
+ ...existingProperties[groupType],
230
+ ...properties[groupType]
231
+ };
232
+ delete properties[groupType];
233
+ });
234
+ this.setPersistedProperty(PostHogPersistedProperty.GroupProperties, {
235
+ ...existingProperties,
236
+ ...properties
237
+ });
238
+ });
239
+ }
240
+ resetGroupPropertiesForFlags() {
241
+ this.wrap(()=>{
242
+ this.setPersistedProperty(PostHogPersistedProperty.GroupProperties, null);
243
+ });
244
+ }
245
+ async remoteConfigAsync() {
246
+ await this._initPromise;
247
+ if (this._remoteConfigResponsePromise) return this._remoteConfigResponsePromise;
248
+ return this._remoteConfigAsync();
249
+ }
250
+ async flagsAsync(sendAnonDistinctId = true) {
251
+ await this._initPromise;
252
+ if (this._flagsResponsePromise) return this._flagsResponsePromise;
253
+ return this._flagsAsync(sendAnonDistinctId);
254
+ }
255
+ cacheSessionReplay(source, response) {
256
+ const sessionReplay = response?.sessionRecording;
257
+ if (sessionReplay) {
258
+ this.setPersistedProperty(PostHogPersistedProperty.SessionReplay, sessionReplay);
259
+ this.logMsgIfDebug(()=>console.log('PostHog Debug', `Session replay config from ${source}: `, JSON.stringify(sessionReplay)));
260
+ } else if ('boolean' == typeof sessionReplay && false === sessionReplay) {
261
+ this.logMsgIfDebug(()=>console.info('PostHog Debug', `Session replay config from ${source} disabled.`));
262
+ this.setPersistedProperty(PostHogPersistedProperty.SessionReplay, null);
263
+ }
264
+ }
265
+ async _remoteConfigAsync() {
266
+ this._remoteConfigResponsePromise = this._initPromise.then(()=>{
267
+ let remoteConfig = this.getPersistedProperty(PostHogPersistedProperty.RemoteConfig);
268
+ this.logMsgIfDebug(()=>console.log('PostHog Debug', 'Cached remote config: ', JSON.stringify(remoteConfig)));
269
+ return super.getRemoteConfig().then((response)=>{
270
+ if (response) {
271
+ const remoteConfigWithoutSurveys = {
272
+ ...response
273
+ };
274
+ delete remoteConfigWithoutSurveys.surveys;
275
+ this.logMsgIfDebug(()=>console.log('PostHog Debug', 'Fetched remote config: ', JSON.stringify(remoteConfigWithoutSurveys)));
276
+ if (false === this.disableSurveys) {
277
+ const surveys = response.surveys;
278
+ let hasSurveys = true;
279
+ if (Array.isArray(surveys)) this.logMsgIfDebug(()=>console.log('PostHog Debug', 'Surveys fetched from remote config: ', JSON.stringify(surveys)));
280
+ else {
281
+ this.logMsgIfDebug(()=>console.log('PostHog Debug', 'There are no surveys.'));
282
+ hasSurveys = false;
283
+ }
284
+ if (hasSurveys) this.setPersistedProperty(PostHogPersistedProperty.Surveys, surveys);
285
+ else this.setPersistedProperty(PostHogPersistedProperty.Surveys, null);
286
+ } else this.setPersistedProperty(PostHogPersistedProperty.Surveys, null);
287
+ this.setPersistedProperty(PostHogPersistedProperty.RemoteConfig, remoteConfigWithoutSurveys);
288
+ this.cacheSessionReplay('remote config', response);
289
+ if (false === response.hasFeatureFlags) {
290
+ this.setKnownFeatureFlagDetails({
291
+ flags: {}
292
+ });
293
+ this.logMsgIfDebug(()=>console.warn('Remote config has no feature flags, will not load feature flags.'));
294
+ } else if (false !== this.preloadFeatureFlags) this.reloadFeatureFlags();
295
+ if (!response.supportedCompression?.includes(Compression.GZipJS)) this.disableCompression = true;
296
+ remoteConfig = response;
297
+ }
298
+ return remoteConfig;
299
+ });
300
+ }).finally(()=>{
301
+ this._remoteConfigResponsePromise = void 0;
302
+ });
303
+ return this._remoteConfigResponsePromise;
304
+ }
305
+ async _flagsAsync(sendAnonDistinctId = true) {
306
+ this._flagsResponsePromise = this._initPromise.then(async ()=>{
307
+ const distinctId = this.getDistinctId();
308
+ const groups = this.props.$groups || {};
309
+ const personProperties = this.getPersistedProperty(PostHogPersistedProperty.PersonProperties) || {};
310
+ const groupProperties = this.getPersistedProperty(PostHogPersistedProperty.GroupProperties) || {};
311
+ const extraProperties = {
312
+ $anon_distinct_id: sendAnonDistinctId ? this.getAnonymousId() : void 0
313
+ };
314
+ const res = await super.getFlags(distinctId, groups, personProperties, groupProperties, extraProperties);
315
+ if (res?.quotaLimited?.includes(QuotaLimitedFeature.FeatureFlags)) {
316
+ this.setKnownFeatureFlagDetails(null);
317
+ console.warn('[FEATURE FLAGS] Feature flags quota limit exceeded - unsetting all flags. Learn more about billing limits at https://posthog.com/docs/billing/limits-alerts');
318
+ return res;
319
+ }
320
+ if (res?.featureFlags) {
321
+ if (this.sendFeatureFlagEvent) this.flagCallReported = {};
322
+ let newFeatureFlagDetails = res;
323
+ if (res.errorsWhileComputingFlags) {
324
+ const currentFlagDetails = this.getKnownFeatureFlagDetails();
325
+ this.logMsgIfDebug(()=>console.log('PostHog Debug', 'Cached feature flags: ', JSON.stringify(currentFlagDetails)));
326
+ newFeatureFlagDetails = {
327
+ ...res,
328
+ flags: {
329
+ ...currentFlagDetails?.flags,
330
+ ...res.flags
331
+ }
332
+ };
333
+ }
334
+ this.setKnownFeatureFlagDetails(newFeatureFlagDetails);
335
+ this.setPersistedProperty(PostHogPersistedProperty.FlagsEndpointWasHit, true);
336
+ this.cacheSessionReplay('flags', res);
337
+ }
338
+ return res;
339
+ }).finally(()=>{
340
+ this._flagsResponsePromise = void 0;
341
+ });
342
+ return this._flagsResponsePromise;
343
+ }
344
+ setKnownFeatureFlagDetails(flagsResponse) {
345
+ this.wrap(()=>{
346
+ this.setPersistedProperty(PostHogPersistedProperty.FeatureFlagDetails, flagsResponse);
347
+ this._events.emit('featureflags', getFlagValuesFromFlags(flagsResponse?.flags ?? {}));
348
+ });
349
+ }
350
+ getKnownFeatureFlagDetails() {
351
+ const storedDetails = this.getPersistedProperty(PostHogPersistedProperty.FeatureFlagDetails);
352
+ if (!storedDetails) {
353
+ const featureFlags = this.getPersistedProperty(PostHogPersistedProperty.FeatureFlags);
354
+ const featureFlagPayloads = this.getPersistedProperty(PostHogPersistedProperty.FeatureFlagPayloads);
355
+ if (void 0 === featureFlags && void 0 === featureFlagPayloads) return;
356
+ return createFlagsResponseFromFlagsAndPayloads(featureFlags ?? {}, featureFlagPayloads ?? {});
357
+ }
358
+ return normalizeFlagsResponse(storedDetails);
359
+ }
360
+ getKnownFeatureFlags() {
361
+ const featureFlagDetails = this.getKnownFeatureFlagDetails();
362
+ if (!featureFlagDetails) return;
363
+ return getFlagValuesFromFlags(featureFlagDetails.flags);
364
+ }
365
+ getKnownFeatureFlagPayloads() {
366
+ const featureFlagDetails = this.getKnownFeatureFlagDetails();
367
+ if (!featureFlagDetails) return;
368
+ return getPayloadsFromFlags(featureFlagDetails.flags);
369
+ }
370
+ getBootstrappedFeatureFlagDetails() {
371
+ const details = this.getPersistedProperty(PostHogPersistedProperty.BootstrapFeatureFlagDetails);
372
+ if (!details) return;
373
+ return details;
374
+ }
375
+ setBootstrappedFeatureFlagDetails(details) {
376
+ this.setPersistedProperty(PostHogPersistedProperty.BootstrapFeatureFlagDetails, details);
377
+ }
378
+ getBootstrappedFeatureFlags() {
379
+ const details = this.getBootstrappedFeatureFlagDetails();
380
+ if (!details) return;
381
+ return getFlagValuesFromFlags(details.flags);
382
+ }
383
+ getBootstrappedFeatureFlagPayloads() {
384
+ const details = this.getBootstrappedFeatureFlagDetails();
385
+ if (!details) return;
386
+ return getPayloadsFromFlags(details.flags);
387
+ }
388
+ getFeatureFlag(key) {
389
+ const details = this.getFeatureFlagDetails();
390
+ if (!details) return;
391
+ const featureFlag = details.flags[key];
392
+ let response = getFeatureFlagValue(featureFlag);
393
+ if (void 0 === response) response = false;
394
+ if (this.sendFeatureFlagEvent && !this.flagCallReported[key]) {
395
+ const bootstrappedResponse = this.getBootstrappedFeatureFlags()?.[key];
396
+ const bootstrappedPayload = this.getBootstrappedFeatureFlagPayloads()?.[key];
397
+ this.flagCallReported[key] = true;
398
+ this.capture('$feature_flag_called', {
399
+ $feature_flag: key,
400
+ $feature_flag_response: response,
401
+ ...maybeAdd('$feature_flag_id', featureFlag?.metadata?.id),
402
+ ...maybeAdd('$feature_flag_version', featureFlag?.metadata?.version),
403
+ ...maybeAdd('$feature_flag_reason', featureFlag?.reason?.description ?? featureFlag?.reason?.code),
404
+ ...maybeAdd('$feature_flag_bootstrapped_response', bootstrappedResponse),
405
+ ...maybeAdd('$feature_flag_bootstrapped_payload', bootstrappedPayload),
406
+ $used_bootstrap_value: !this.getPersistedProperty(PostHogPersistedProperty.FlagsEndpointWasHit),
407
+ ...maybeAdd('$feature_flag_request_id', details.requestId)
408
+ });
409
+ }
410
+ return response;
411
+ }
412
+ getFeatureFlagPayload(key) {
413
+ const payloads = this.getFeatureFlagPayloads();
414
+ if (!payloads) return;
415
+ const response = payloads[key];
416
+ if (void 0 === response) return null;
417
+ return response;
418
+ }
419
+ getFeatureFlagPayloads() {
420
+ return this.getFeatureFlagDetails()?.featureFlagPayloads;
421
+ }
422
+ getFeatureFlags() {
423
+ return this.getFeatureFlagDetails()?.featureFlags;
424
+ }
425
+ getFeatureFlagDetails() {
426
+ let details = this.getKnownFeatureFlagDetails();
427
+ const overriddenFlags = this.getPersistedProperty(PostHogPersistedProperty.OverrideFeatureFlags);
428
+ if (!overriddenFlags) return details;
429
+ details = details ?? {
430
+ featureFlags: {},
431
+ featureFlagPayloads: {},
432
+ flags: {}
433
+ };
434
+ const flags = details.flags ?? {};
435
+ for(const key in overriddenFlags)if (overriddenFlags[key]) flags[key] = updateFlagValue(flags[key], overriddenFlags[key]);
436
+ else delete flags[key];
437
+ const result = {
438
+ ...details,
439
+ flags
440
+ };
441
+ return normalizeFlagsResponse(result);
442
+ }
443
+ getFeatureFlagsAndPayloads() {
444
+ const flags = this.getFeatureFlags();
445
+ const payloads = this.getFeatureFlagPayloads();
446
+ return {
447
+ flags,
448
+ payloads
449
+ };
450
+ }
451
+ isFeatureEnabled(key) {
452
+ const response = this.getFeatureFlag(key);
453
+ if (void 0 === response) return;
454
+ return !!response;
455
+ }
456
+ reloadFeatureFlags(options) {
457
+ this.flagsAsync(true).then((res)=>{
458
+ options?.cb?.(void 0, res?.featureFlags);
459
+ }).catch((e)=>{
460
+ options?.cb?.(e, void 0);
461
+ if (!options?.cb) this.logMsgIfDebug(()=>console.log('PostHog Debug', 'Error reloading feature flags', e));
462
+ });
463
+ }
464
+ async reloadRemoteConfigAsync() {
465
+ return await this.remoteConfigAsync();
466
+ }
467
+ async reloadFeatureFlagsAsync(sendAnonDistinctId) {
468
+ return (await this.flagsAsync(sendAnonDistinctId ?? true))?.featureFlags;
469
+ }
470
+ onFeatureFlags(cb) {
471
+ return this.on('featureflags', async ()=>{
472
+ const flags = this.getFeatureFlags();
473
+ if (flags) cb(flags);
474
+ });
475
+ }
476
+ onFeatureFlag(key, cb) {
477
+ return this.on('featureflags', async ()=>{
478
+ const flagResponse = this.getFeatureFlag(key);
479
+ if (void 0 !== flagResponse) cb(flagResponse);
480
+ });
481
+ }
482
+ async overrideFeatureFlag(flags) {
483
+ this.wrap(()=>{
484
+ if (null === flags) return this.setPersistedProperty(PostHogPersistedProperty.OverrideFeatureFlags, null);
485
+ return this.setPersistedProperty(PostHogPersistedProperty.OverrideFeatureFlags, flags);
486
+ });
487
+ }
488
+ captureException(error, additionalProperties) {
489
+ const properties = {
490
+ $exception_level: 'error',
491
+ $exception_list: [
492
+ {
493
+ type: isPlainError(error) ? error.name : 'Error',
494
+ value: isPlainError(error) ? error.message : error,
495
+ mechanism: {
496
+ handled: true,
497
+ synthetic: false
498
+ }
499
+ }
500
+ ],
501
+ ...additionalProperties
502
+ };
503
+ properties.$exception_personURL = new URL(`/project/${this.apiKey}/person/${this.getDistinctId()}`, this.host).toString();
504
+ this.capture('$exception', properties);
505
+ }
506
+ captureTraceFeedback(traceId, userFeedback) {
507
+ this.capture('$ai_feedback', {
508
+ $ai_feedback_text: userFeedback,
509
+ $ai_trace_id: String(traceId)
510
+ });
511
+ }
512
+ captureTraceMetric(traceId, metricName, metricValue) {
513
+ this.capture('$ai_metric', {
514
+ $ai_metric_name: metricName,
515
+ $ai_metric_value: String(metricValue),
516
+ $ai_trace_id: String(traceId)
517
+ });
518
+ }
519
+ }
520
+ export { PostHogCore };
@@ -1,4 +1,5 @@
1
- import { JsonType, PostHogCore, PostHogCoreOptions, PostHogFetchOptions, PostHogFetchResponse, PostHogFlagsResponse } from '../../src';
1
+ import { PostHogCore } from '../posthog-core';
2
+ import type { JsonType, PostHogCoreOptions, PostHogFetchOptions, PostHogFetchResponse, PostHogFlagsResponse } from '../types';
2
3
  export interface PostHogCoreTestClientMocks {
3
4
  fetch: jest.Mock<Promise<PostHogFetchResponse>, [string, PostHogFetchOptions]>;
4
5
  storage: {
@@ -1 +1 @@
1
- {"version":3,"file":"PostHogCoreTestClient.d.ts","sourceRoot":"","sources":["../../src/testing/PostHogCoreTestClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,WAAW,CAAA;AAIlB,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAA;IAC9E,OAAO,EAAE;QACP,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;QAC7C,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,CAAC,CAAA;KAC/C,CAAA;CACF;AAED,qBAAa,qBAAsB,SAAQ,WAAW;IAIlD,OAAO,CAAC,KAAK;IAHR,iBAAiB,CAAC,EAAE,MAAM,CAAA;gBAGvB,KAAK,EAAE,0BAA0B,EACzC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,kBAAkB;IAQvB,QAAQ,CACb,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAM,EAC5C,gBAAgB,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAC7C,eAAe,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,EAC5D,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GACrC,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;IAI5C,oBAAoB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;IAGvC,oBAAoB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAG3D,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAG/E,YAAY,IAAI,MAAM;IAGtB,iBAAiB,IAAI,MAAM;IAG3B,kBAAkB,IAAI,MAAM;CAG7B;AAED,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,MAAM,EACd,UAAU,kBAAkB,EAC5B,aAAa,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,EACxD,eAAc;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;CAAO,KACtD,CAAC,qBAAqB,EAAE,0BAA0B,CAsBpD,CAAA"}
1
+ {"version":3,"file":"PostHogCoreTestClient.d.ts","sourceRoot":"","sources":["../../src/testing/PostHogCoreTestClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EACV,QAAQ,EACR,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACrB,MAAM,SAAS,CAAA;AAIhB,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAA;IAC9E,OAAO,EAAE;QACP,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;QAC7C,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,CAAC,CAAA;KAC/C,CAAA;CACF;AAED,qBAAa,qBAAsB,SAAQ,WAAW;IAIlD,OAAO,CAAC,KAAK;IAHR,iBAAiB,CAAC,EAAE,MAAM,CAAA;gBAGvB,KAAK,EAAE,0BAA0B,EACzC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,kBAAkB;IAQvB,QAAQ,CACb,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAM,EAC5C,gBAAgB,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,EAC7C,eAAe,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,EAC5D,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GACrC,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;IAI5C,oBAAoB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;IAGvC,oBAAoB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAG3D,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAG/E,YAAY,IAAI,MAAM;IAGtB,iBAAiB,IAAI,MAAM;IAG3B,kBAAkB,IAAI,MAAM;CAG7B;AAED,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,MAAM,EACd,UAAU,kBAAkB,EAC5B,aAAa,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,EACxD,eAAc;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;CAAO,KACtD,CAAC,qBAAqB,EAAE,0BAA0B,CAsBpD,CAAA"}
@@ -27,11 +27,14 @@ __webpack_require__.d(__webpack_exports__, {
27
27
  PostHogCoreTestClient: ()=>PostHogCoreTestClient,
28
28
  createTestClient: ()=>createTestClient
29
29
  });
30
- const external_index_js_namespaceObject = require("../index.js");
30
+ const external_posthog_core_js_namespaceObject = require("../posthog-core.js");
31
31
  const version = '2.0.0-alpha';
32
- class PostHogCoreTestClient extends external_index_js_namespaceObject.PostHogCore {
33
- getFlags(distinctId) {
34
- let groups = arguments.length > 1 && void 0 !== arguments[1] ? arguments[1] : {}, personProperties = arguments.length > 2 && void 0 !== arguments[2] ? arguments[2] : {}, groupProperties = arguments.length > 3 && void 0 !== arguments[3] ? arguments[3] : {}, extraPayload = arguments.length > 4 && void 0 !== arguments[4] ? arguments[4] : {};
32
+ class PostHogCoreTestClient extends external_posthog_core_js_namespaceObject.PostHogCore {
33
+ constructor(mocks, apiKey, options){
34
+ super(apiKey, options), this.mocks = mocks;
35
+ this.setupBootstrap(options);
36
+ }
37
+ getFlags(distinctId, groups = {}, personProperties = {}, groupProperties = {}, extraPayload = {}) {
35
38
  return super.getFlags(distinctId, groups, personProperties, groupProperties, extraPayload);
36
39
  }
37
40
  getPersistedProperty(key) {
@@ -52,13 +55,8 @@ class PostHogCoreTestClient extends external_index_js_namespaceObject.PostHogCor
52
55
  getCustomUserAgent() {
53
56
  return 'posthog-core-tests';
54
57
  }
55
- constructor(mocks, apiKey, options){
56
- super(apiKey, options), this.mocks = mocks;
57
- this.setupBootstrap(options);
58
- }
59
58
  }
60
- const createTestClient = function(apiKey, options, setupMocks) {
61
- let storageCache = arguments.length > 3 && void 0 !== arguments[3] ? arguments[3] : {};
59
+ const createTestClient = (apiKey, options, setupMocks, storageCache = {})=>{
62
60
  const mocks = {
63
61
  fetch: jest.fn(),
64
62
  storage: {
@@ -75,7 +73,7 @@ const createTestClient = function(apiKey, options, setupMocks) {
75
73
  status: 'ok'
76
74
  })
77
75
  }));
78
- null == setupMocks || setupMocks(mocks);
76
+ setupMocks?.(mocks);
79
77
  return [
80
78
  new PostHogCoreTestClient(mocks, apiKey, {
81
79
  disableCompression: true,
@@ -1,8 +1,11 @@
1
- import { PostHogCore } from "../index.mjs";
1
+ import { PostHogCore } from "../posthog-core.mjs";
2
2
  const version = '2.0.0-alpha';
3
3
  class PostHogCoreTestClient extends PostHogCore {
4
- getFlags(distinctId) {
5
- let groups = arguments.length > 1 && void 0 !== arguments[1] ? arguments[1] : {}, personProperties = arguments.length > 2 && void 0 !== arguments[2] ? arguments[2] : {}, groupProperties = arguments.length > 3 && void 0 !== arguments[3] ? arguments[3] : {}, extraPayload = arguments.length > 4 && void 0 !== arguments[4] ? arguments[4] : {};
4
+ constructor(mocks, apiKey, options){
5
+ super(apiKey, options), this.mocks = mocks;
6
+ this.setupBootstrap(options);
7
+ }
8
+ getFlags(distinctId, groups = {}, personProperties = {}, groupProperties = {}, extraPayload = {}) {
6
9
  return super.getFlags(distinctId, groups, personProperties, groupProperties, extraPayload);
7
10
  }
8
11
  getPersistedProperty(key) {
@@ -23,13 +26,8 @@ class PostHogCoreTestClient extends PostHogCore {
23
26
  getCustomUserAgent() {
24
27
  return 'posthog-core-tests';
25
28
  }
26
- constructor(mocks, apiKey, options){
27
- super(apiKey, options), this.mocks = mocks;
28
- this.setupBootstrap(options);
29
- }
30
29
  }
31
- const createTestClient = function(apiKey, options, setupMocks) {
32
- let storageCache = arguments.length > 3 && void 0 !== arguments[3] ? arguments[3] : {};
30
+ const createTestClient = (apiKey, options, setupMocks, storageCache = {})=>{
33
31
  const mocks = {
34
32
  fetch: jest.fn(),
35
33
  storage: {
@@ -46,7 +44,7 @@ const createTestClient = function(apiKey, options, setupMocks) {
46
44
  status: 'ok'
47
45
  })
48
46
  }));
49
- null == setupMocks || setupMocks(mocks);
47
+ setupMocks?.(mocks);
50
48
  return [
51
49
  new PostHogCoreTestClient(mocks, apiKey, {
52
50
  disableCompression: true,
@@ -53,7 +53,7 @@ const createImperativePromise = ()=>{
53
53
  });
54
54
  return [
55
55
  promise,
56
- (val)=>null == resolve ? void 0 : resolve(val)
56
+ (val)=>resolve?.(val)
57
57
  ];
58
58
  };
59
59
  const delay = (ms)=>new Promise((resolve)=>{
@@ -20,7 +20,7 @@ const createImperativePromise = ()=>{
20
20
  });
21
21
  return [
22
22
  promise,
23
- (val)=>null == resolve ? void 0 : resolve(val)
23
+ (val)=>resolve?.(val)
24
24
  ];
25
25
  };
26
26
  const delay = (ms)=>new Promise((resolve)=>{