@metamask-previews/analytics-controller 2.0.0-preview-0d04fb622 → 2.0.0-preview-6b7c25c
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.
- package/CHANGELOG.md +0 -4
- package/README.md +5 -46
- package/dist/AnalyticsController-method-action-types.cjs.map +1 -1
- package/dist/AnalyticsController-method-action-types.d.cts +2 -102
- package/dist/AnalyticsController-method-action-types.d.cts.map +1 -1
- package/dist/AnalyticsController-method-action-types.d.mts +2 -102
- package/dist/AnalyticsController-method-action-types.d.mts.map +1 -1
- package/dist/AnalyticsController-method-action-types.mjs.map +1 -1
- package/dist/AnalyticsController.cjs +13 -341
- package/dist/AnalyticsController.cjs.map +1 -1
- package/dist/AnalyticsController.d.cts +2 -105
- package/dist/AnalyticsController.d.cts.map +1 -1
- package/dist/AnalyticsController.d.mts +2 -105
- package/dist/AnalyticsController.d.mts.map +1 -1
- package/dist/AnalyticsController.mjs +13 -341
- package/dist/AnalyticsController.mjs.map +1 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +1 -2
- package/dist/index.d.cts.map +1 -1
- package/dist/index.d.mts +1 -2
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs.map +1 -1
- package/dist/selectors.cjs +0 -19
- package/dist/selectors.cjs.map +1 -1
- package/dist/selectors.d.cts +0 -3
- package/dist/selectors.d.cts.map +1 -1
- package/dist/selectors.d.mts +0 -3
- package/dist/selectors.d.mts.map +1 -1
- package/dist/selectors.mjs +0 -19
- package/dist/selectors.mjs.map +1 -1
- package/package.json +1 -1
- package/dist/EventFragment.types.cjs +0 -3
- package/dist/EventFragment.types.cjs.map +0 -1
- package/dist/EventFragment.types.d.cts +0 -88
- package/dist/EventFragment.types.d.cts.map +0 -1
- package/dist/EventFragment.types.d.mts +0 -88
- package/dist/EventFragment.types.d.mts.map +0 -1
- package/dist/EventFragment.types.mjs +0 -2
- package/dist/EventFragment.types.mjs.map +0 -1
|
@@ -5,7 +5,6 @@ import type { Messenger } from "@metamask/messenger";
|
|
|
5
5
|
import type { Json } from "@metamask/utils";
|
|
6
6
|
import type { AnalyticsControllerMethodActions } from "./AnalyticsController-method-action-types.mjs";
|
|
7
7
|
import type { AnalyticsPlatformAdapter, AnalyticsContext, AnalyticsEventProperties, AnalyticsUserTraits, AnalyticsTrackingEvent } from "./AnalyticsPlatformAdapter.types.mjs";
|
|
8
|
-
import type { AnalyticsEventFragment, AnalyticsEventFragmentFinalizeOptions, AnalyticsEventFragmentOptions, AnalyticsEventFragmentPayload, AnalyticsEventFragments } from "./EventFragment.types.mjs";
|
|
9
8
|
/**
|
|
10
9
|
* The name of the {@link AnalyticsController}, used to namespace the
|
|
11
10
|
* controller's actions and events and to namespace the controller's state data
|
|
@@ -51,13 +50,6 @@ export type AnalyticsControllerState = {
|
|
|
51
50
|
* This is only used when the pre-consent queue is enabled.
|
|
52
51
|
*/
|
|
53
52
|
preConsentEventQueue?: Record<string, Json>;
|
|
54
|
-
/**
|
|
55
|
-
* Persisted event fragments ({@link AnalyticsEventFragment}) keyed by
|
|
56
|
-
* fragment ID. Fragments accumulate properties across a user journey and are
|
|
57
|
-
* removed when the journey is finalized or deleted.
|
|
58
|
-
* This is only used when the event fragments feature is enabled.
|
|
59
|
-
*/
|
|
60
|
-
eventFragments?: AnalyticsEventFragments;
|
|
61
53
|
};
|
|
62
54
|
/**
|
|
63
55
|
* Event types supported by the persisted analytics event queue.
|
|
@@ -210,18 +202,6 @@ export type AnalyticsControllerOptions = {
|
|
|
210
202
|
* @default false
|
|
211
203
|
*/
|
|
212
204
|
isGeolocationEnabled?: boolean;
|
|
213
|
-
/**
|
|
214
|
-
* Whether the event fragments feature is enabled.
|
|
215
|
-
*
|
|
216
|
-
* When enabled, clients can accumulate analytics properties across a user
|
|
217
|
-
* journey with {@link AnalyticsController.createEventFragment} and friends,
|
|
218
|
-
* as long as the consent state allows analytics to be captured. When
|
|
219
|
-
* disabled, every fragment method is a logged no-op and no fragment is ever
|
|
220
|
-
* written to state.
|
|
221
|
-
*
|
|
222
|
-
* @default false
|
|
223
|
-
*/
|
|
224
|
-
isEventFragmentsEnabled?: boolean;
|
|
225
205
|
};
|
|
226
206
|
/**
|
|
227
207
|
* The AnalyticsController manages analytics tracking across platforms (Mobile/Extension).
|
|
@@ -250,11 +230,10 @@ export declare class AnalyticsController extends BaseController<'AnalyticsContro
|
|
|
250
230
|
* @param options.isEventQueuePersistenceEnabled - Whether analytics event queue persistence is enabled
|
|
251
231
|
* @param options.isPreConsentQueueEnabled - Whether the pre-consent event queue is enabled
|
|
252
232
|
* @param options.isGeolocationEnabled - Whether geolocation enrichment is enabled
|
|
253
|
-
* @param options.isEventFragmentsEnabled - Whether the event fragments feature is enabled
|
|
254
233
|
* @throws Error if state.analyticsId is missing or not a valid UUIDv4
|
|
255
234
|
* @remarks After construction, call {@link AnalyticsController.init} to complete initialization.
|
|
256
235
|
*/
|
|
257
|
-
constructor({ state, messenger, platformAdapter, isAnonymousEventsFeatureEnabled, isEventQueuePersistenceEnabled, isPreConsentQueueEnabled, isGeolocationEnabled,
|
|
236
|
+
constructor({ state, messenger, platformAdapter, isAnonymousEventsFeatureEnabled, isEventQueuePersistenceEnabled, isPreConsentQueueEnabled, isGeolocationEnabled, }: AnalyticsControllerOptions);
|
|
258
237
|
/**
|
|
259
238
|
* Initialize the controller by calling the platform adapter's
|
|
260
239
|
* onSetupCompleted lifecycle hook and replaying any queued events. This
|
|
@@ -299,83 +278,6 @@ export declare class AnalyticsController extends BaseController<'AnalyticsContro
|
|
|
299
278
|
* @param context - Optional platform-specific context forwarded to the platform adapter.
|
|
300
279
|
*/
|
|
301
280
|
trackView(name: string, properties?: AnalyticsEventProperties, context?: AnalyticsContext): void;
|
|
302
|
-
/**
|
|
303
|
-
* Create an event fragment.
|
|
304
|
-
*
|
|
305
|
-
* A fragment accumulates properties across a user journey so that several
|
|
306
|
-
* parts of a client can contribute to the same set of events without
|
|
307
|
-
* re-deriving them. Declaring `successEvent` and `failureEvent` turns the
|
|
308
|
-
* fragment into a funnel that {@link finalizeEventFragment} closes. Declaring
|
|
309
|
-
* none of the event names makes it a pure property bag that the client reads
|
|
310
|
-
* back with {@link getEventFragmentById} when it emits its own events.
|
|
311
|
-
*
|
|
312
|
-
* Any existing fragment with the same ID is replaced, so a new journey never
|
|
313
|
-
* inherits properties from a stale one.
|
|
314
|
-
*
|
|
315
|
-
* Nothing is created unless the user is opted in, or undecided with the
|
|
316
|
-
* pre-consent queue enabled, so an opted-out user accumulates no fragment
|
|
317
|
-
* data.
|
|
318
|
-
*
|
|
319
|
-
* @param options - The fragment definition. An ID is generated when one is
|
|
320
|
-
* not supplied.
|
|
321
|
-
* @returns The created fragment, or `undefined` when the event fragments
|
|
322
|
-
* feature is disabled or the consent state does not allow capture.
|
|
323
|
-
*/
|
|
324
|
-
createEventFragment(options?: AnalyticsEventFragmentOptions): AnalyticsEventFragment | undefined;
|
|
325
|
-
/**
|
|
326
|
-
* Write to an event fragment, creating a property bag if none exists.
|
|
327
|
-
*
|
|
328
|
-
* This is the ergonomic entry point for contributors that do not know
|
|
329
|
-
* whether the journey has been started yet, and it avoids the read then
|
|
330
|
-
* write race a caller would otherwise have to implement itself.
|
|
331
|
-
*
|
|
332
|
-
* @param id - The fragment ID.
|
|
333
|
-
* @param payload - The properties and context to merge in.
|
|
334
|
-
*/
|
|
335
|
-
upsertEventFragment(id: string, payload?: AnalyticsEventFragmentPayload): void;
|
|
336
|
-
/**
|
|
337
|
-
* Write to an existing event fragment.
|
|
338
|
-
*
|
|
339
|
-
* @param id - The fragment ID.
|
|
340
|
-
* @param payload - The properties and context to merge in.
|
|
341
|
-
* @throws Error if no fragment has that ID when the call is not ignored.
|
|
342
|
-
* Use {@link upsertEventFragment} when the fragment may not exist yet.
|
|
343
|
-
* When the event fragments feature is disabled or the consent state does not
|
|
344
|
-
* allow capture, the call is a logged no-op and does not throw.
|
|
345
|
-
*/
|
|
346
|
-
updateEventFragment(id: string, payload?: AnalyticsEventFragmentPayload): void;
|
|
347
|
-
/**
|
|
348
|
-
* Read an event fragment.
|
|
349
|
-
*
|
|
350
|
-
* @param id - The fragment ID.
|
|
351
|
-
* @returns The fragment, or `undefined` when no fragment has that ID, the
|
|
352
|
-
* event fragments feature is disabled, or the consent state does not allow
|
|
353
|
-
* capture.
|
|
354
|
-
*/
|
|
355
|
-
getEventFragmentById(id: string): AnalyticsEventFragment | undefined;
|
|
356
|
-
/**
|
|
357
|
-
* Discard an event fragment without emitting anything.
|
|
358
|
-
*
|
|
359
|
-
* @param id - The fragment ID.
|
|
360
|
-
*/
|
|
361
|
-
deleteEventFragment(id: string): void;
|
|
362
|
-
/**
|
|
363
|
-
* Close an event fragment, emitting its closing event and discarding it.
|
|
364
|
-
*
|
|
365
|
-
* The event emitted is `failureEvent` when the journey was abandoned and
|
|
366
|
-
* `successEvent` otherwise. A fragment that does not declare the relevant
|
|
367
|
-
* event name is discarded silently, which is what makes a pure property bag
|
|
368
|
-
* possible.
|
|
369
|
-
*
|
|
370
|
-
* @param id - The fragment ID.
|
|
371
|
-
* @param options - Finalization options.
|
|
372
|
-
* @param options.abandoned - Whether the journey was abandoned.
|
|
373
|
-
* @param options.context - Context merged over the fragment's own context.
|
|
374
|
-
* @throws Error if no fragment has that ID when the call is not ignored.
|
|
375
|
-
* When the event fragments feature is disabled or the consent state does not
|
|
376
|
-
* allow capture, the call is a logged no-op and does not throw.
|
|
377
|
-
*/
|
|
378
|
-
finalizeEventFragment(id: string, { abandoned, context }?: AnalyticsEventFragmentFinalizeOptions): void;
|
|
379
281
|
/**
|
|
380
282
|
* Opt in to analytics.
|
|
381
283
|
*
|
|
@@ -393,8 +295,7 @@ export declare class AnalyticsController extends BaseController<'AnalyticsContro
|
|
|
393
295
|
* Opt out of analytics.
|
|
394
296
|
*
|
|
395
297
|
* Records that a consent decision has been made and discards any persisted
|
|
396
|
-
* events
|
|
397
|
-
* decision is ever delivered.
|
|
298
|
+
* events so nothing captured before the decision is ever delivered.
|
|
398
299
|
*/
|
|
399
300
|
optOut(): void;
|
|
400
301
|
/**
|
|
@@ -404,10 +305,6 @@ export declare class AnalyticsController extends BaseController<'AnalyticsContro
|
|
|
404
305
|
* preference and discards the delivery queue, but preserves any pre-consent
|
|
405
306
|
* events so they can still be replayed if the user opts in again. The user is
|
|
406
307
|
* treated as undecided again.
|
|
407
|
-
*
|
|
408
|
-
* In-progress event fragments are kept only while the undecided user can
|
|
409
|
-
* still accumulate them, and discarded otherwise, so no fragment outlives the
|
|
410
|
-
* consent state that allowed it.
|
|
411
308
|
*/
|
|
412
309
|
resetConsentDecision(): void;
|
|
413
310
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"AnalyticsController.d.mts","sourceRoot":"","sources":["../src/AnalyticsController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAE3B,kCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,kCAAkC;AAC3D,OAAO,KAAK,EACV,6CAA6C,EAE9C,yCAAyC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,4BAA4B;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,wBAAwB;AAI5C,OAAO,KAAK,EAAE,gCAAgC,EAAE,sDAAqD;AAGrG,OAAO,KAAK,EACV,wBAAwB,EAExB,gBAAgB,EAChB,wBAAwB,EAExB,mBAAmB,EACnB,sBAAsB,EACvB,6CAAyC;
|
|
1
|
+
{"version":3,"file":"AnalyticsController.d.mts","sourceRoot":"","sources":["../src/AnalyticsController.ts"],"names":[],"mappings":"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"}
|
|
@@ -9,7 +9,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
|
|
|
9
9
|
if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
|
|
10
10
|
return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
|
|
11
11
|
};
|
|
12
|
-
var _AnalyticsController_instances, _AnalyticsController_platformAdapter, _AnalyticsController_isAnonymousEventsFeatureEnabled, _AnalyticsController_isEventQueuePersistenceEnabled, _AnalyticsController_isPreConsentQueueEnabled, _AnalyticsController_isGeolocationEnabled,
|
|
12
|
+
var _AnalyticsController_instances, _AnalyticsController_platformAdapter, _AnalyticsController_isAnonymousEventsFeatureEnabled, _AnalyticsController_isEventQueuePersistenceEnabled, _AnalyticsController_isPreConsentQueueEnabled, _AnalyticsController_isGeolocationEnabled, _AnalyticsController_initPromise, _AnalyticsController_locationResolvePromise, _AnalyticsController_locationContext, _AnalyticsController_performInit, _AnalyticsController_maybeResolveLocation, _AnalyticsController_resolveLocationContext, _AnalyticsController_withLocationContext, _AnalyticsController_sendOrQueueTrackEvent, _AnalyticsController_sendOrQueueIdentifyEvent, _AnalyticsController_sendOrQueueViewEvent, _AnalyticsController_enqueueEvent, _AnalyticsController_sendQueuedEvent, _AnalyticsController_replayQueuedEvents, _AnalyticsController_removeQueuedEvent, _AnalyticsController_clearQueuedEvents, _AnalyticsController_enqueuePreConsentEvent, _AnalyticsController_replayPreConsentEvents, _AnalyticsController_enrichPreConsentEvent, _AnalyticsController_clearPreConsentEvents, _AnalyticsController_reconcilePreConsentEvents;
|
|
13
13
|
import { BaseController } from "@metamask/base-controller";
|
|
14
14
|
import $lodash from "lodash";
|
|
15
15
|
const { cloneDeep } = $lodash;
|
|
@@ -75,12 +75,6 @@ const analyticsControllerMetadata = {
|
|
|
75
75
|
includeInDebugSnapshot: false,
|
|
76
76
|
usedInUi: false,
|
|
77
77
|
},
|
|
78
|
-
eventFragments: {
|
|
79
|
-
includeInStateLogs: false,
|
|
80
|
-
persist: true,
|
|
81
|
-
includeInDebugSnapshot: false,
|
|
82
|
-
usedInUi: false,
|
|
83
|
-
},
|
|
84
78
|
};
|
|
85
79
|
// === MESSENGER ===
|
|
86
80
|
const MESSENGER_EXPOSED_METHODS = [
|
|
@@ -90,12 +84,6 @@ const MESSENGER_EXPOSED_METHODS = [
|
|
|
90
84
|
'optIn',
|
|
91
85
|
'optOut',
|
|
92
86
|
'resetConsentDecision',
|
|
93
|
-
'createEventFragment',
|
|
94
|
-
'upsertEventFragment',
|
|
95
|
-
'updateEventFragment',
|
|
96
|
-
'getEventFragmentById',
|
|
97
|
-
'deleteEventFragment',
|
|
98
|
-
'finalizeEventFragment',
|
|
99
87
|
];
|
|
100
88
|
/**
|
|
101
89
|
* Returns whether a value is a non-array object.
|
|
@@ -167,69 +155,6 @@ function isAnalyticsQueuedEvent(value) {
|
|
|
167
155
|
}
|
|
168
156
|
return false;
|
|
169
157
|
}
|
|
170
|
-
/**
|
|
171
|
-
* Returns whether a value is a valid persisted event fragment.
|
|
172
|
-
*
|
|
173
|
-
* @param value - The value to check.
|
|
174
|
-
* @returns True if the value is an event fragment.
|
|
175
|
-
*/
|
|
176
|
-
function isAnalyticsEventFragment(value) {
|
|
177
|
-
if (!isRecord(value)) {
|
|
178
|
-
return false;
|
|
179
|
-
}
|
|
180
|
-
return (typeof value.id === 'string' &&
|
|
181
|
-
typeof value.createdAt === 'number' &&
|
|
182
|
-
typeof value.lastUpdated === 'number' &&
|
|
183
|
-
isRecord(value.properties) &&
|
|
184
|
-
isRecord(value.sensitiveProperties) &&
|
|
185
|
-
(value.initialEvent === undefined ||
|
|
186
|
-
typeof value.initialEvent === 'string') &&
|
|
187
|
-
(value.successEvent === undefined ||
|
|
188
|
-
typeof value.successEvent === 'string') &&
|
|
189
|
-
(value.failureEvent === undefined ||
|
|
190
|
-
typeof value.failureEvent === 'string') &&
|
|
191
|
-
(value.context === undefined || isRecord(value.context)) &&
|
|
192
|
-
(value.persist === undefined || typeof value.persist === 'boolean'));
|
|
193
|
-
}
|
|
194
|
-
/**
|
|
195
|
-
* Merges a payload into an event fragment.
|
|
196
|
-
*
|
|
197
|
-
* `properties`, `sensitiveProperties` and `context` are merged one level deep,
|
|
198
|
-
* so a key written twice is replaced rather than combined. This keeps array
|
|
199
|
-
* values predictable: writing a shorter array replaces the longer one instead
|
|
200
|
-
* of leaving stale trailing entries behind.
|
|
201
|
-
*
|
|
202
|
-
* @param fragment - The fragment to merge into.
|
|
203
|
-
* @param payload - The payload to merge.
|
|
204
|
-
* @returns A new fragment with the payload applied.
|
|
205
|
-
*/
|
|
206
|
-
function mergeEventFragment(fragment, payload) {
|
|
207
|
-
const context = mergeEventFragmentContext(fragment.context, payload.context);
|
|
208
|
-
return {
|
|
209
|
-
...fragment,
|
|
210
|
-
properties: { ...fragment.properties, ...(payload.properties ?? {}) },
|
|
211
|
-
sensitiveProperties: {
|
|
212
|
-
...fragment.sensitiveProperties,
|
|
213
|
-
...(payload.sensitiveProperties ?? {}),
|
|
214
|
-
},
|
|
215
|
-
...(context === undefined ? {} : { context }),
|
|
216
|
-
lastUpdated: Date.now(),
|
|
217
|
-
};
|
|
218
|
-
}
|
|
219
|
-
/**
|
|
220
|
-
* Merges two optional analytics contexts, preserving `undefined` when neither
|
|
221
|
-
* side has one so an empty context is never sent.
|
|
222
|
-
*
|
|
223
|
-
* @param base - The context to merge into.
|
|
224
|
-
* @param override - The context whose fields win.
|
|
225
|
-
* @returns The merged context, or `undefined` when both sides are unset.
|
|
226
|
-
*/
|
|
227
|
-
function mergeEventFragmentContext(base, override) {
|
|
228
|
-
if (base === undefined && override === undefined) {
|
|
229
|
-
return undefined;
|
|
230
|
-
}
|
|
231
|
-
return { ...(base ?? {}), ...(override ?? {}) };
|
|
232
|
-
}
|
|
233
158
|
/**
|
|
234
159
|
* The AnalyticsController manages analytics tracking across platforms (Mobile/Extension).
|
|
235
160
|
* It provides a unified interface for tracking events, identifying users, and managing
|
|
@@ -256,11 +181,10 @@ export class AnalyticsController extends BaseController {
|
|
|
256
181
|
* @param options.isEventQueuePersistenceEnabled - Whether analytics event queue persistence is enabled
|
|
257
182
|
* @param options.isPreConsentQueueEnabled - Whether the pre-consent event queue is enabled
|
|
258
183
|
* @param options.isGeolocationEnabled - Whether geolocation enrichment is enabled
|
|
259
|
-
* @param options.isEventFragmentsEnabled - Whether the event fragments feature is enabled
|
|
260
184
|
* @throws Error if state.analyticsId is missing or not a valid UUIDv4
|
|
261
185
|
* @remarks After construction, call {@link AnalyticsController.init} to complete initialization.
|
|
262
186
|
*/
|
|
263
|
-
constructor({ state, messenger, platformAdapter, isAnonymousEventsFeatureEnabled = false, isEventQueuePersistenceEnabled = false, isPreConsentQueueEnabled = false, isGeolocationEnabled = false,
|
|
187
|
+
constructor({ state, messenger, platformAdapter, isAnonymousEventsFeatureEnabled = false, isEventQueuePersistenceEnabled = false, isPreConsentQueueEnabled = false, isGeolocationEnabled = false, }) {
|
|
264
188
|
const initialState = {
|
|
265
189
|
...getDefaultAnalyticsControllerState(),
|
|
266
190
|
...state,
|
|
@@ -278,7 +202,6 @@ export class AnalyticsController extends BaseController {
|
|
|
278
202
|
_AnalyticsController_isEventQueuePersistenceEnabled.set(this, void 0);
|
|
279
203
|
_AnalyticsController_isPreConsentQueueEnabled.set(this, void 0);
|
|
280
204
|
_AnalyticsController_isGeolocationEnabled.set(this, void 0);
|
|
281
|
-
_AnalyticsController_isEventFragmentsEnabled.set(this, void 0);
|
|
282
205
|
/**
|
|
283
206
|
* The in-flight (or settled) initialization promise. Set on the first
|
|
284
207
|
* {@link init} call and returned by subsequent calls so overlapping callers
|
|
@@ -295,7 +218,6 @@ export class AnalyticsController extends BaseController {
|
|
|
295
218
|
__classPrivateFieldSet(this, _AnalyticsController_isEventQueuePersistenceEnabled, isEventQueuePersistenceEnabled, "f");
|
|
296
219
|
__classPrivateFieldSet(this, _AnalyticsController_isPreConsentQueueEnabled, isPreConsentQueueEnabled, "f");
|
|
297
220
|
__classPrivateFieldSet(this, _AnalyticsController_isGeolocationEnabled, isGeolocationEnabled, "f");
|
|
298
|
-
__classPrivateFieldSet(this, _AnalyticsController_isEventFragmentsEnabled, isEventFragmentsEnabled, "f");
|
|
299
221
|
__classPrivateFieldSet(this, _AnalyticsController_platformAdapter, platformAdapter, "f");
|
|
300
222
|
__classPrivateFieldSet(this, _AnalyticsController_initPromise, undefined, "f");
|
|
301
223
|
__classPrivateFieldSet(this, _AnalyticsController_locationResolvePromise, undefined, "f");
|
|
@@ -308,7 +230,6 @@ export class AnalyticsController extends BaseController {
|
|
|
308
230
|
eventQueuePersistenceEnabled: __classPrivateFieldGet(this, _AnalyticsController_isEventQueuePersistenceEnabled, "f"),
|
|
309
231
|
preConsentQueueEnabled: __classPrivateFieldGet(this, _AnalyticsController_isPreConsentQueueEnabled, "f"),
|
|
310
232
|
geolocationEnabled: __classPrivateFieldGet(this, _AnalyticsController_isGeolocationEnabled, "f"),
|
|
311
|
-
eventFragmentsEnabled: __classPrivateFieldGet(this, _AnalyticsController_isEventFragmentsEnabled, "f"),
|
|
312
233
|
});
|
|
313
234
|
}
|
|
314
235
|
/**
|
|
@@ -346,11 +267,15 @@ export class AnalyticsController extends BaseController {
|
|
|
346
267
|
* @param context - Optional platform-specific context forwarded to the platform adapter.
|
|
347
268
|
*/
|
|
348
269
|
trackEvent(event, context) {
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
|
|
353
|
-
|
|
270
|
+
if (!analyticsControllerSelectors.selectEnabled(this.state)) {
|
|
271
|
+
// While the user is undecided, fall through so the event is processed and
|
|
272
|
+
// captured in the pre-consent queue (see #sendOrQueueTrackEvent) to be
|
|
273
|
+
// replayed if they later opt in. Otherwise (opted out, or pre-consent
|
|
274
|
+
// queue disabled) drop it.
|
|
275
|
+
const shouldQueuePreConsent = __classPrivateFieldGet(this, _AnalyticsController_isPreConsentQueueEnabled, "f") && !this.state.consentDecisionMade;
|
|
276
|
+
if (!shouldQueuePreConsent) {
|
|
277
|
+
return;
|
|
278
|
+
}
|
|
354
279
|
}
|
|
355
280
|
// if event does not have properties, send event without properties
|
|
356
281
|
// and return to prevent any additional processing
|
|
@@ -408,153 +333,6 @@ export class AnalyticsController extends BaseController {
|
|
|
408
333
|
// Delegate to platform adapter
|
|
409
334
|
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_sendOrQueueViewEvent).call(this, name, properties, __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_withLocationContext).call(this, context));
|
|
410
335
|
}
|
|
411
|
-
/**
|
|
412
|
-
* Create an event fragment.
|
|
413
|
-
*
|
|
414
|
-
* A fragment accumulates properties across a user journey so that several
|
|
415
|
-
* parts of a client can contribute to the same set of events without
|
|
416
|
-
* re-deriving them. Declaring `successEvent` and `failureEvent` turns the
|
|
417
|
-
* fragment into a funnel that {@link finalizeEventFragment} closes. Declaring
|
|
418
|
-
* none of the event names makes it a pure property bag that the client reads
|
|
419
|
-
* back with {@link getEventFragmentById} when it emits its own events.
|
|
420
|
-
*
|
|
421
|
-
* Any existing fragment with the same ID is replaced, so a new journey never
|
|
422
|
-
* inherits properties from a stale one.
|
|
423
|
-
*
|
|
424
|
-
* Nothing is created unless the user is opted in, or undecided with the
|
|
425
|
-
* pre-consent queue enabled, so an opted-out user accumulates no fragment
|
|
426
|
-
* data.
|
|
427
|
-
*
|
|
428
|
-
* @param options - The fragment definition. An ID is generated when one is
|
|
429
|
-
* not supplied.
|
|
430
|
-
* @returns The created fragment, or `undefined` when the event fragments
|
|
431
|
-
* feature is disabled or the consent state does not allow capture.
|
|
432
|
-
*/
|
|
433
|
-
createEventFragment(options = {}) {
|
|
434
|
-
if (__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_shouldIgnoreEventFragmentCall).call(this, 'createEventFragment')) {
|
|
435
|
-
return undefined;
|
|
436
|
-
}
|
|
437
|
-
const now = Date.now();
|
|
438
|
-
const fragment = {
|
|
439
|
-
id: options.id ?? uuid(),
|
|
440
|
-
properties: { ...(options.properties ?? {}) },
|
|
441
|
-
sensitiveProperties: { ...(options.sensitiveProperties ?? {}) },
|
|
442
|
-
createdAt: now,
|
|
443
|
-
lastUpdated: now,
|
|
444
|
-
...(options.initialEvent === undefined
|
|
445
|
-
? {}
|
|
446
|
-
: { initialEvent: options.initialEvent }),
|
|
447
|
-
...(options.successEvent === undefined
|
|
448
|
-
? {}
|
|
449
|
-
: { successEvent: options.successEvent }),
|
|
450
|
-
...(options.failureEvent === undefined
|
|
451
|
-
? {}
|
|
452
|
-
: { failureEvent: options.failureEvent }),
|
|
453
|
-
...(options.context === undefined ? {} : { context: options.context }),
|
|
454
|
-
...(options.persist === undefined ? {} : { persist: options.persist }),
|
|
455
|
-
};
|
|
456
|
-
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_setEventFragment).call(this, fragment);
|
|
457
|
-
if (fragment.initialEvent) {
|
|
458
|
-
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_emitEventFragment).call(this, fragment, fragment.initialEvent, fragment.context);
|
|
459
|
-
}
|
|
460
|
-
return fragment;
|
|
461
|
-
}
|
|
462
|
-
/**
|
|
463
|
-
* Write to an event fragment, creating a property bag if none exists.
|
|
464
|
-
*
|
|
465
|
-
* This is the ergonomic entry point for contributors that do not know
|
|
466
|
-
* whether the journey has been started yet, and it avoids the read then
|
|
467
|
-
* write race a caller would otherwise have to implement itself.
|
|
468
|
-
*
|
|
469
|
-
* @param id - The fragment ID.
|
|
470
|
-
* @param payload - The properties and context to merge in.
|
|
471
|
-
*/
|
|
472
|
-
upsertEventFragment(id, payload = {}) {
|
|
473
|
-
if (__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_shouldIgnoreEventFragmentCall).call(this, 'upsertEventFragment')) {
|
|
474
|
-
return;
|
|
475
|
-
}
|
|
476
|
-
const fragment = __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_getEventFragment).call(this, id);
|
|
477
|
-
if (!fragment) {
|
|
478
|
-
this.createEventFragment({ id, ...payload });
|
|
479
|
-
return;
|
|
480
|
-
}
|
|
481
|
-
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_setEventFragment).call(this, mergeEventFragment(fragment, payload));
|
|
482
|
-
}
|
|
483
|
-
/**
|
|
484
|
-
* Write to an existing event fragment.
|
|
485
|
-
*
|
|
486
|
-
* @param id - The fragment ID.
|
|
487
|
-
* @param payload - The properties and context to merge in.
|
|
488
|
-
* @throws Error if no fragment has that ID when the call is not ignored.
|
|
489
|
-
* Use {@link upsertEventFragment} when the fragment may not exist yet.
|
|
490
|
-
* When the event fragments feature is disabled or the consent state does not
|
|
491
|
-
* allow capture, the call is a logged no-op and does not throw.
|
|
492
|
-
*/
|
|
493
|
-
updateEventFragment(id, payload = {}) {
|
|
494
|
-
if (__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_shouldIgnoreEventFragmentCall).call(this, 'updateEventFragment')) {
|
|
495
|
-
return;
|
|
496
|
-
}
|
|
497
|
-
const fragment = __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_getEventFragment).call(this, id);
|
|
498
|
-
if (!fragment) {
|
|
499
|
-
throw new Error(`Event fragment with id ${id} does not exist.`);
|
|
500
|
-
}
|
|
501
|
-
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_setEventFragment).call(this, mergeEventFragment(fragment, payload));
|
|
502
|
-
}
|
|
503
|
-
/**
|
|
504
|
-
* Read an event fragment.
|
|
505
|
-
*
|
|
506
|
-
* @param id - The fragment ID.
|
|
507
|
-
* @returns The fragment, or `undefined` when no fragment has that ID, the
|
|
508
|
-
* event fragments feature is disabled, or the consent state does not allow
|
|
509
|
-
* capture.
|
|
510
|
-
*/
|
|
511
|
-
getEventFragmentById(id) {
|
|
512
|
-
if (__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_shouldIgnoreEventFragmentCall).call(this, 'getEventFragmentById')) {
|
|
513
|
-
return undefined;
|
|
514
|
-
}
|
|
515
|
-
return __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_getEventFragment).call(this, id);
|
|
516
|
-
}
|
|
517
|
-
/**
|
|
518
|
-
* Discard an event fragment without emitting anything.
|
|
519
|
-
*
|
|
520
|
-
* @param id - The fragment ID.
|
|
521
|
-
*/
|
|
522
|
-
deleteEventFragment(id) {
|
|
523
|
-
if (__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_shouldIgnoreEventFragmentCall).call(this, 'deleteEventFragment')) {
|
|
524
|
-
return;
|
|
525
|
-
}
|
|
526
|
-
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_removeEventFragment).call(this, id);
|
|
527
|
-
}
|
|
528
|
-
/**
|
|
529
|
-
* Close an event fragment, emitting its closing event and discarding it.
|
|
530
|
-
*
|
|
531
|
-
* The event emitted is `failureEvent` when the journey was abandoned and
|
|
532
|
-
* `successEvent` otherwise. A fragment that does not declare the relevant
|
|
533
|
-
* event name is discarded silently, which is what makes a pure property bag
|
|
534
|
-
* possible.
|
|
535
|
-
*
|
|
536
|
-
* @param id - The fragment ID.
|
|
537
|
-
* @param options - Finalization options.
|
|
538
|
-
* @param options.abandoned - Whether the journey was abandoned.
|
|
539
|
-
* @param options.context - Context merged over the fragment's own context.
|
|
540
|
-
* @throws Error if no fragment has that ID when the call is not ignored.
|
|
541
|
-
* When the event fragments feature is disabled or the consent state does not
|
|
542
|
-
* allow capture, the call is a logged no-op and does not throw.
|
|
543
|
-
*/
|
|
544
|
-
finalizeEventFragment(id, { abandoned = false, context } = {}) {
|
|
545
|
-
if (__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_shouldIgnoreEventFragmentCall).call(this, 'finalizeEventFragment')) {
|
|
546
|
-
return;
|
|
547
|
-
}
|
|
548
|
-
const fragment = __classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_getEventFragment).call(this, id);
|
|
549
|
-
if (!fragment) {
|
|
550
|
-
throw new Error(`Event fragment with id ${id} does not exist.`);
|
|
551
|
-
}
|
|
552
|
-
const eventName = abandoned ? fragment.failureEvent : fragment.successEvent;
|
|
553
|
-
if (eventName) {
|
|
554
|
-
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_emitEventFragment).call(this, fragment, eventName, mergeEventFragmentContext(fragment.context, context));
|
|
555
|
-
}
|
|
556
|
-
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_removeEventFragment).call(this, id);
|
|
557
|
-
}
|
|
558
336
|
/**
|
|
559
337
|
* Opt in to analytics.
|
|
560
338
|
*
|
|
@@ -585,8 +363,7 @@ export class AnalyticsController extends BaseController {
|
|
|
585
363
|
* Opt out of analytics.
|
|
586
364
|
*
|
|
587
365
|
* Records that a consent decision has been made and discards any persisted
|
|
588
|
-
* events
|
|
589
|
-
* decision is ever delivered.
|
|
366
|
+
* events so nothing captured before the decision is ever delivered.
|
|
590
367
|
*/
|
|
591
368
|
optOut() {
|
|
592
369
|
this.update((state) => {
|
|
@@ -595,7 +372,6 @@ export class AnalyticsController extends BaseController {
|
|
|
595
372
|
});
|
|
596
373
|
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_clearQueuedEvents).call(this);
|
|
597
374
|
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_clearPreConsentEvents).call(this);
|
|
598
|
-
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_clearEventFragments).call(this);
|
|
599
375
|
}
|
|
600
376
|
/**
|
|
601
377
|
* Reset the consent decision back to undecided.
|
|
@@ -604,10 +380,6 @@ export class AnalyticsController extends BaseController {
|
|
|
604
380
|
* preference and discards the delivery queue, but preserves any pre-consent
|
|
605
381
|
* events so they can still be replayed if the user opts in again. The user is
|
|
606
382
|
* treated as undecided again.
|
|
607
|
-
*
|
|
608
|
-
* In-progress event fragments are kept only while the undecided user can
|
|
609
|
-
* still accumulate them, and discarded otherwise, so no fragment outlives the
|
|
610
|
-
* consent state that allowed it.
|
|
611
383
|
*/
|
|
612
384
|
resetConsentDecision() {
|
|
613
385
|
this.update((state) => {
|
|
@@ -615,29 +387,15 @@ export class AnalyticsController extends BaseController {
|
|
|
615
387
|
state.consentDecisionMade = false;
|
|
616
388
|
});
|
|
617
389
|
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_clearQueuedEvents).call(this);
|
|
618
|
-
if (!__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_isAnalyticsCaptureAllowed).call(this)) {
|
|
619
|
-
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_clearEventFragments).call(this);
|
|
620
|
-
}
|
|
621
390
|
}
|
|
622
391
|
}
|
|
623
|
-
_AnalyticsController_platformAdapter = new WeakMap(), _AnalyticsController_isAnonymousEventsFeatureEnabled = new WeakMap(), _AnalyticsController_isEventQueuePersistenceEnabled = new WeakMap(), _AnalyticsController_isPreConsentQueueEnabled = new WeakMap(), _AnalyticsController_isGeolocationEnabled = new WeakMap(),
|
|
392
|
+
_AnalyticsController_platformAdapter = new WeakMap(), _AnalyticsController_isAnonymousEventsFeatureEnabled = new WeakMap(), _AnalyticsController_isEventQueuePersistenceEnabled = new WeakMap(), _AnalyticsController_isPreConsentQueueEnabled = new WeakMap(), _AnalyticsController_isGeolocationEnabled = new WeakMap(), _AnalyticsController_initPromise = new WeakMap(), _AnalyticsController_locationResolvePromise = new WeakMap(), _AnalyticsController_locationContext = new WeakMap(), _AnalyticsController_instances = new WeakSet(), _AnalyticsController_performInit =
|
|
624
393
|
/**
|
|
625
394
|
* Performs the one-time initialization work: resolve geolocation, run the
|
|
626
395
|
* platform adapter's onSetupCompleted lifecycle hook, then replay any queued
|
|
627
396
|
* and pre-consent events.
|
|
628
397
|
*/
|
|
629
398
|
async function _AnalyticsController_performInit() {
|
|
630
|
-
// Snapshot fragment IDs and createdAt before any awaited init work so
|
|
631
|
-
// reconciliation can tell previous-session leftovers from fragments
|
|
632
|
-
// created or replaced while init runs.
|
|
633
|
-
const initEventFragmentSnapshot = new Map();
|
|
634
|
-
for (const [id, fragment] of Object.entries(this.state.eventFragments ?? {})) {
|
|
635
|
-
if (isAnalyticsEventFragment(fragment) &&
|
|
636
|
-
fragment.id === id &&
|
|
637
|
-
typeof fragment.createdAt === 'number') {
|
|
638
|
-
initEventFragmentSnapshot.set(id, fragment.createdAt);
|
|
639
|
-
}
|
|
640
|
-
}
|
|
641
399
|
// Resolve geolocation only when the user is already opted in; for undecided
|
|
642
400
|
// or opted-out users it is deferred to {@link optIn}. Awaited so that an
|
|
643
401
|
// already-opted-in session has location available before events replay.
|
|
@@ -653,7 +411,6 @@ async function _AnalyticsController_performInit() {
|
|
|
653
411
|
}
|
|
654
412
|
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_replayQueuedEvents).call(this);
|
|
655
413
|
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_reconcilePreConsentEvents).call(this);
|
|
656
|
-
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_reconcileEventFragments).call(this, initEventFragmentSnapshot);
|
|
657
414
|
}, _AnalyticsController_maybeResolveLocation = function _AnalyticsController_maybeResolveLocation() {
|
|
658
415
|
if (__classPrivateFieldGet(this, _AnalyticsController_isGeolocationEnabled, "f") &&
|
|
659
416
|
__classPrivateFieldGet(this, _AnalyticsController_locationResolvePromise, "f") === undefined &&
|
|
@@ -876,90 +633,5 @@ async function _AnalyticsController_performInit() {
|
|
|
876
633
|
else if (this.state.consentDecisionMade) {
|
|
877
634
|
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_clearPreConsentEvents).call(this);
|
|
878
635
|
}
|
|
879
|
-
}, _AnalyticsController_reconcileEventFragments = function _AnalyticsController_reconcileEventFragments(initEventFragmentSnapshot) {
|
|
880
|
-
const fragments = this.state.eventFragments;
|
|
881
|
-
if (!fragments) {
|
|
882
|
-
return;
|
|
883
|
-
}
|
|
884
|
-
if (!__classPrivateFieldGet(this, _AnalyticsController_isEventFragmentsEnabled, "f") || !__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_isAnalyticsCaptureAllowed).call(this)) {
|
|
885
|
-
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_clearEventFragments).call(this);
|
|
886
|
-
return;
|
|
887
|
-
}
|
|
888
|
-
__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_purgeNonPersistentEventFragments).call(this, fragments, initEventFragmentSnapshot);
|
|
889
|
-
}, _AnalyticsController_purgeNonPersistentEventFragments = function _AnalyticsController_purgeNonPersistentEventFragments(currentEventFragments, initEventFragmentSnapshot) {
|
|
890
|
-
const eventFragments = {};
|
|
891
|
-
for (const [id, fragment] of Object.entries(currentEventFragments)) {
|
|
892
|
-
if (!isAnalyticsEventFragment(fragment) || fragment.id !== id) {
|
|
893
|
-
log('Dropping invalid persisted event fragment', { id });
|
|
894
|
-
continue;
|
|
895
|
-
}
|
|
896
|
-
const snapshotCreatedAt = initEventFragmentSnapshot.get(id);
|
|
897
|
-
if (fragment.persist === true ||
|
|
898
|
-
snapshotCreatedAt === undefined ||
|
|
899
|
-
fragment.createdAt !== snapshotCreatedAt) {
|
|
900
|
-
eventFragments[id] = fragment;
|
|
901
|
-
}
|
|
902
|
-
}
|
|
903
|
-
if (Object.keys(eventFragments).length ===
|
|
904
|
-
Object.keys(currentEventFragments).length) {
|
|
905
|
-
return;
|
|
906
|
-
}
|
|
907
|
-
this.update((state) => {
|
|
908
|
-
state.eventFragments = eventFragments;
|
|
909
|
-
});
|
|
910
|
-
}, _AnalyticsController_getEventFragment = function _AnalyticsController_getEventFragment(id) {
|
|
911
|
-
return this.state.eventFragments?.[id];
|
|
912
|
-
}, _AnalyticsController_setEventFragment = function _AnalyticsController_setEventFragment(fragment) {
|
|
913
|
-
const eventFragments = {
|
|
914
|
-
...this.state.eventFragments,
|
|
915
|
-
[fragment.id]: fragment,
|
|
916
|
-
};
|
|
917
|
-
this.update((state) => {
|
|
918
|
-
state.eventFragments = eventFragments;
|
|
919
|
-
});
|
|
920
|
-
}, _AnalyticsController_removeEventFragment = function _AnalyticsController_removeEventFragment(id) {
|
|
921
|
-
const currentEventFragments = this.state.eventFragments;
|
|
922
|
-
if (!currentEventFragments ||
|
|
923
|
-
!Object.prototype.hasOwnProperty.call(currentEventFragments, id)) {
|
|
924
|
-
return;
|
|
925
|
-
}
|
|
926
|
-
const { [id]: _deletedFragment, ...eventFragments } = currentEventFragments;
|
|
927
|
-
this.update((state) => {
|
|
928
|
-
state.eventFragments = eventFragments;
|
|
929
|
-
});
|
|
930
|
-
}, _AnalyticsController_clearEventFragments = function _AnalyticsController_clearEventFragments() {
|
|
931
|
-
if (!this.state.eventFragments ||
|
|
932
|
-
Object.keys(this.state.eventFragments).length === 0) {
|
|
933
|
-
return;
|
|
934
|
-
}
|
|
935
|
-
this.update((state) => {
|
|
936
|
-
state.eventFragments = {};
|
|
937
|
-
});
|
|
938
|
-
}, _AnalyticsController_shouldIgnoreEventFragmentCall = function _AnalyticsController_shouldIgnoreEventFragmentCall(method) {
|
|
939
|
-
if (!__classPrivateFieldGet(this, _AnalyticsController_isEventFragmentsEnabled, "f")) {
|
|
940
|
-
log('Ignoring event fragment call because the event fragments feature is disabled', { method });
|
|
941
|
-
return true;
|
|
942
|
-
}
|
|
943
|
-
if (!__classPrivateFieldGet(this, _AnalyticsController_instances, "m", _AnalyticsController_isAnalyticsCaptureAllowed).call(this)) {
|
|
944
|
-
log('Ignoring event fragment call because the consent state does not allow capturing analytics', { method });
|
|
945
|
-
return true;
|
|
946
|
-
}
|
|
947
|
-
return false;
|
|
948
|
-
}, _AnalyticsController_emitEventFragment = function _AnalyticsController_emitEventFragment(fragment, name, context) {
|
|
949
|
-
const properties = { ...fragment.properties };
|
|
950
|
-
const sensitiveProperties = { ...fragment.sensitiveProperties };
|
|
951
|
-
this.trackEvent({
|
|
952
|
-
name,
|
|
953
|
-
properties,
|
|
954
|
-
sensitiveProperties,
|
|
955
|
-
saveDataRecording: false,
|
|
956
|
-
hasProperties: Object.keys(properties).length > 0 ||
|
|
957
|
-
Object.keys(sensitiveProperties).length > 0,
|
|
958
|
-
}, context);
|
|
959
|
-
}, _AnalyticsController_isAnalyticsCaptureAllowed = function _AnalyticsController_isAnalyticsCaptureAllowed() {
|
|
960
|
-
if (analyticsControllerSelectors.selectEnabled(this.state)) {
|
|
961
|
-
return true;
|
|
962
|
-
}
|
|
963
|
-
return __classPrivateFieldGet(this, _AnalyticsController_isPreConsentQueueEnabled, "f") && !this.state.consentDecisionMade;
|
|
964
636
|
};
|
|
965
637
|
//# sourceMappingURL=AnalyticsController.mjs.map
|