@amplitude/plugin-engaged-time-tracking-browser 0.0.0-stage → 1.1.0-cursorvideo-click-cell-9eb2.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 (35) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +74 -2
  3. package/lib/cjs/engaged-time-tracking.d.ts +4 -0
  4. package/lib/cjs/engaged-time-tracking.d.ts.map +1 -0
  5. package/lib/cjs/engaged-time-tracking.js +162 -0
  6. package/lib/cjs/engaged-time-tracking.js.map +1 -0
  7. package/lib/cjs/index.d.ts +2 -0
  8. package/lib/cjs/index.d.ts.map +1 -0
  9. package/lib/cjs/index.js +7 -0
  10. package/lib/cjs/index.js.map +1 -0
  11. package/lib/cjs/page-engagement.d.ts +15 -0
  12. package/lib/cjs/page-engagement.d.ts.map +1 -0
  13. package/lib/cjs/page-engagement.js +238 -0
  14. package/lib/cjs/page-engagement.js.map +1 -0
  15. package/lib/esm/engaged-time-tracking.d.ts +4 -0
  16. package/lib/esm/engaged-time-tracking.d.ts.map +1 -0
  17. package/lib/esm/engaged-time-tracking.js +158 -0
  18. package/lib/esm/engaged-time-tracking.js.map +1 -0
  19. package/lib/esm/index.d.ts +2 -0
  20. package/lib/esm/index.d.ts.map +1 -0
  21. package/lib/esm/index.js +2 -0
  22. package/lib/esm/index.js.map +1 -0
  23. package/lib/esm/page-engagement.d.ts +15 -0
  24. package/lib/esm/page-engagement.d.ts.map +1 -0
  25. package/lib/esm/page-engagement.js +234 -0
  26. package/lib/esm/page-engagement.js.map +1 -0
  27. package/lib/scripts/amplitude-min.umd.js +1 -0
  28. package/lib/scripts/amplitude-min.umd.js.gz +0 -0
  29. package/lib/scripts/engaged-time-tracking.d.ts +4 -0
  30. package/lib/scripts/engaged-time-tracking.d.ts.map +1 -0
  31. package/lib/scripts/index.d.ts +2 -0
  32. package/lib/scripts/index.d.ts.map +1 -0
  33. package/lib/scripts/page-engagement.d.ts +15 -0
  34. package/lib/scripts/page-engagement.d.ts.map +1 -0
  35. package/package.json +52 -3
@@ -0,0 +1 @@
1
+ {"version":3,"file":"page-engagement.js","sourceRoot":"","sources":["../../src/page-engagement.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n getGlobalScope,\n BrowserClient,\n Event,\n Heartbeat,\n BrowserConfig,\n ILogger,\n EngagedTimeOptions,\n UUID,\n} from '@amplitude/analytics-core';\n\nexport const DEFAULT_ACTIVITY_WINDOW = 5_000;\nexport const DEFAULT_ENGAGEMENT_HEARTBEAT = 15_000;\nexport const DEFAULT_INACTIVITY_TIMEOUT = 180_000;\nconst BACKGROUND_SEND_INTERVAL = 1_000;\n\ninterface PageState {\n event: Event;\n heartbeat: Heartbeat;\n pulseTimer?: ReturnType<typeof setInterval>;\n started: number;\n updated: number;\n lastActivity: number;\n engaged: number;\n version: number;\n nextSnapshotReason: 'initial' | 'heartbeat' | 'background';\n lastBackgroundSent?: number;\n backgroundTimer?: ReturnType<typeof setTimeout>;\n}\n\n// Browser timers use a signed 32-bit millisecond delay. Larger values can overflow.\nconst MAX_TIMER_DELAY_MILLIS = 2_147_483_647;\n// The delayed-event service rejects request timeouts greater than 24 hours.\nconst MAX_INACTIVITY_TIMEOUT_MILLIS = 86_400_000;\n\nfunction resolveDurationMillis(\n value: number | undefined,\n defaultValue: number,\n logger: ILogger,\n maximum = MAX_TIMER_DELAY_MILLIS,\n): number {\n if (value === undefined) return defaultValue;\n if (!Number.isFinite(value) || value <= 0 || value > maximum) {\n logger.warn(\n `Page engagement: invalid duration ${value} ms; using default ${defaultValue} ms. Expected 0 < finite duration <= ${maximum} ms.`,\n );\n return defaultValue;\n }\n return value;\n}\n\n/** Owns one page-view delay group at a time, independently of the video heartbeat.\n * Keep per-owner state in a closure so ES5 bundles can minify internal names.\n */\nexport const createPageEngagement = (\n client: BrowserClient,\n scope: NonNullable<ReturnType<typeof getGlobalScope>>,\n options: EngagedTimeOptions,\n config: BrowserConfig,\n newPageView: () => void,\n) => {\n let currentPage: PageState | undefined;\n let inactivityTimer: ReturnType<typeof setTimeout> | undefined;\n let foreground = isForeground();\n let enabled = true;\n let skippedPage = false;\n const removeListeners: (() => void)[] = [];\n const timeout = resolveDurationMillis(\n options.inactivityTimeoutMillis,\n DEFAULT_INACTIVITY_TIMEOUT,\n config.loggerProvider,\n MAX_INACTIVITY_TIMEOUT_MILLIS,\n );\n const activityWindow = resolveDurationMillis(\n options.activityWindowMillis,\n DEFAULT_ACTIVITY_WINDOW,\n config.loggerProvider,\n );\n const pulse = Math.min(\n resolveDurationMillis(options.heartbeatIntervalMillis, DEFAULT_ENGAGEMENT_HEARTBEAT, config.loggerProvider),\n timeout / 2,\n );\n\n function isForeground() {\n return scope.document.visibilityState === 'visible' && scope.document.hasFocus();\n }\n\n function start(event: Event): Event | undefined {\n finish('navigation');\n if (!enabled) return undefined;\n const now = Date.now();\n foreground = isForeground();\n const pageState: PageState = {\n event: {\n ...event,\n // Capture top-level properties; snapshots add timing without mutating this object.\n event_properties: { ...event.event_properties },\n insert_id: event.insert_id || UUID(),\n time: event.time ?? now,\n // Share the SDK inactivity duration with the service fallback. The SDK counts\n // from last activity; the service counts from the last accepted heartbeat.\n delay: { id: UUID(), timeout },\n },\n heartbeat: new Heartbeat(client, pulse, timeout, config.loggerProvider, {\n // This owner settles elapsed time and finalizes before sending.\n // Avoid a second set of lifecycle sends.\n sendOnPageLifecycle: false,\n beforeHeartbeat: () => {\n // A heartbeat scheduled by the previous page must not update the new page state.\n if (currentPage === pageState) {\n if (Date.now() >= pageState.lastActivity + timeout) {\n retire(pageState, 'inactivity');\n } else {\n void pageState.heartbeat.update(snapshot(pageState, pageState.nextSnapshotReason));\n pageState.nextSnapshotReason = 'heartbeat';\n }\n }\n },\n }),\n started: now,\n updated: now,\n lastActivity: now,\n engaged: 0,\n version: 0,\n nextSnapshotReason: 'heartbeat',\n };\n // Arrival after server expiry must not overwrite more recent identify updates.\n delete pageState.event.user_properties;\n const initial = snapshot(pageState, 'initial');\n let isEnqueued = false;\n try {\n isEnqueued = pageState.heartbeat.enqueue(initial);\n } catch {\n // Heartbeat's size check serializes the event and can reject invalid source data.\n pageState.heartbeat.stop();\n }\n if (!isEnqueued) {\n // Do not turn subsequent activity on this page into repeated fallback views.\n skippedPage = true;\n config.loggerProvider.warn(\n 'Page engagement: snapshot cannot be queued (invalid data or size limit); sending without engaged-time tracking.',\n );\n return undefined;\n }\n currentPage = pageState;\n scheduleInactivity();\n // The original pipeline sends initial. Start only the periodic pulse here;\n // Heartbeat.resetHeartbeat() would send a duplicate initial copy.\n pageState.pulseTimer = setInterval(() => void pageState.heartbeat.heartbeat(), pulse);\n return initial;\n }\n\n function settle(pageState: PageState) {\n // Cap a late callback at the inactivity deadline; heartbeats never extend it.\n const now = Math.max(pageState.updated, Math.min(Date.now(), pageState.lastActivity + timeout));\n if (foreground) {\n pageState.engaged += Math.max(0, Math.min(now, pageState.lastActivity + activityWindow) - pageState.updated);\n }\n pageState.updated = now;\n }\n\n function snapshot(pageState: PageState, reason: string): Event {\n settle(pageState);\n const version = ++pageState.version;\n return {\n ...pageState.event,\n ...(reason === 'initial' ? {} : { extra: { ...pageState.event.extra, engagedTimeReplay: true } }),\n event_properties: {\n ...pageState.event.event_properties,\n '[Amplitude] Engaged Time': pageState.engaged,\n '[Amplitude] Total Time': pageState.updated - pageState.started,\n // Internal diagnostics; version counts constructed snapshots, not requests.\n '[Amplitude] Snapshot Version': version,\n '[Amplitude] Engagement Snapshot Reason': reason,\n },\n };\n }\n\n function scheduleInactivity() {\n clearTimeout(inactivityTimer);\n inactivityTimer = setTimeout(() => finish('inactivity'), timeout);\n }\n\n const activity = () => {\n if (\n !enabled ||\n skippedPage ||\n !foreground ||\n (scope.document as Document & { prerendering?: boolean }).prerendering\n )\n return;\n if (currentPage && Date.now() >= currentPage.lastActivity + timeout) finish('inactivity');\n if (!currentPage) {\n newPageView();\n return;\n }\n settle(currentPage);\n currentPage.lastActivity = Date.now();\n scheduleInactivity();\n };\n\n const resume = () => {\n if (scope.document.visibilityState !== 'visible') return;\n if (currentPage) settle(currentPage);\n foreground = true;\n activity();\n };\n\n const pause = () => {\n if (currentPage) settle(currentPage);\n foreground = false;\n if (currentPage) {\n sendBackground(currentPage);\n }\n };\n\n function sendBackground(pageState: PageState) {\n const remaining =\n pageState.lastBackgroundSent === undefined\n ? 0\n : pageState.lastBackgroundSent + BACKGROUND_SEND_INTERVAL - Date.now();\n if (remaining > 0) {\n // blur and hidden can describe the same transition. Keep a single trailing\n // send at the original deadline, using the latest state when it fires.\n if (pageState.backgroundTimer === undefined) {\n pageState.backgroundTimer = setTimeout(() => {\n pageState.backgroundTimer = undefined;\n sendBackground(pageState);\n }, remaining);\n }\n return;\n }\n clearTimeout(pageState.backgroundTimer);\n pageState.backgroundTimer = undefined;\n pageState.lastBackgroundSent = Date.now();\n pageState.nextSnapshotReason = 'background';\n void pageState.heartbeat.heartbeat();\n client.flush();\n }\n\n function retire(pageState: PageState, reason: string) {\n clearInterval(pageState.pulseTimer);\n clearTimeout(pageState.backgroundTimer);\n clearTimeout(inactivityTimer);\n const event = snapshot(pageState, reason);\n event.delay = { ...event.delay!, timeout: undefined };\n void pageState.heartbeat.update(event);\n pageState.heartbeat.pause();\n currentPage = undefined;\n }\n\n function finish(reason: string) {\n skippedPage = false;\n const pageState = currentPage;\n if (!pageState) return;\n retire(pageState, reason);\n // Enqueue the final copy before clearing this page's heartbeat. Destination\n // coalesces pending snapshots and preserves in-flight ordering by delay ID.\n // Session/identity hooks run before Browser config updates. Defer delivery\n // until that update completes to avoid reentering session creation from track().\n void Promise.resolve().then(() => {\n void pageState.heartbeat.heartbeat();\n // flush() drains the timeline before flushing destination queues.\n client.flush();\n pageState.heartbeat.stop();\n });\n }\n\n function setOptOut(optOut: boolean) {\n enabled = !optOut;\n if (optOut) {\n skippedPage = false;\n clearTimeout(inactivityTimer);\n clearTimeout(currentPage?.backgroundTimer);\n clearInterval(currentPage?.pulseTimer);\n currentPage?.heartbeat.stop();\n currentPage = undefined;\n }\n }\n\n function teardown() {\n finish('teardown');\n enabled = false;\n removeListeners.forEach((remove) => remove());\n }\n\n const listen = (target: EventTarget, type: string, listener: EventListener) => {\n target.addEventListener(type, listener, { passive: true });\n removeListeners.push(() => target.removeEventListener(type, listener));\n };\n ['pointerdown', 'pointermove', 'keydown', 'scroll', 'touchstart', 'wheel'].forEach((type) => {\n listen(scope.document, type, activity);\n });\n listen(scope, 'focus', resume);\n listen(scope, 'blur', pause);\n listen(scope.document, 'visibilitychange', () => (isForeground() ? resume() : pause()));\n // Leaving the document always ends this view, including entry into BFCache.\n listen(scope, 'pagehide', () => finish('pagehide'));\n listen(scope, 'pageshow', () => {\n // A restored page starts a fresh view through the existing activity path.\n if (isForeground()) resume();\n });\n\n return { start, finish, setOptOut, teardown };\n};\n\nexport type PageEngagement = ReturnType<typeof createPageEngagement>;\n"]}
@@ -0,0 +1,4 @@
1
+ import { EngagedTimeOptions, EnrichmentPlugin } from '@amplitude/analytics-core';
2
+ /** Observe configured page views; only idle/lifecycle recovery creates replacement views. */
3
+ export declare const engagedTimeTrackingPlugin: (options?: EngagedTimeOptions) => EnrichmentPlugin;
4
+ //# sourceMappingURL=engaged-time-tracking.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engaged-time-tracking.d.ts","sourceRoot":"","sources":["../../src/engaged-time-tracking.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,kBAAkB,EAClB,gBAAgB,EAGjB,MAAM,2BAA2B,CAAC;AAGnC,6FAA6F;AAC7F,eAAO,MAAM,yBAAyB,aAAa,kBAAkB,KAAQ,gBAuJ5E,CAAC"}
@@ -0,0 +1,158 @@
1
+ import { __assign } from "tslib";
2
+ import { DEFAULT_PAGE_VIEW_EVENT, getGlobalScope, } from '@amplitude/analytics-core';
3
+ import { createPageEngagement } from './page-engagement';
4
+ /** Observe configured page views; only idle/lifecycle recovery creates replacement views. */
5
+ export var engagedTimeTrackingPlugin = function (options) {
6
+ var _a, _b;
7
+ if (options === void 0) { options = {}; }
8
+ // Exact application PageView event name to observe.
9
+ var eventType = (_a = options.pageViewEventType) !== null && _a !== void 0 ? _a : DEFAULT_PAGE_VIEW_EVENT;
10
+ // Generated lifecycle renewals can use a separate analytics event name.
11
+ var secondaryEventType = (_b = options.secondaryPageViewEventType) !== null && _b !== void 0 ? _b : eventType;
12
+ // Tracks the current view's elapsed time, activity, and heartbeat.
13
+ var pageEngagement;
14
+ // Shared SDK settings, including the current opt-out value.
15
+ var browserConfig;
16
+ // Blocks renewal after pagehide until pageshow, including BFCache.
17
+ var exited = false;
18
+ // Prevents this plugin from generating events after teardown.
19
+ var installed = false;
20
+ // URL of the last accepted view; renewal waits on this same URL.
21
+ var pageHref;
22
+ // Invalidates queued events across identity, session, consent, or exit boundaries.
23
+ var cancellation = 0;
24
+ // Advances for each accepted view so an older renewal cannot replace it.
25
+ var revision = 0;
26
+ // Identifies an in-flight renewal to suppress repeated activity/focus requests.
27
+ var pendingContext;
28
+ // Removes the before-plugin that stamps each event's lifecycle context.
29
+ var removeContext;
30
+ // Unsubscribes this plugin's DOM lifecycle listeners during teardown.
31
+ var removeListeners = [];
32
+ // Reuses a completed promise for synchronous plugin hooks.
33
+ var resolved = Promise.resolve();
34
+ // Cancels stale queued events and finalizes the active view.
35
+ var finish = function (reason) {
36
+ cancellation += 1;
37
+ pageEngagement === null || pageEngagement === void 0 ? void 0 : pageEngagement.finish(reason);
38
+ };
39
+ return {
40
+ name: '@amplitude/plugin-engaged-time-tracking-browser',
41
+ type: 'enrichment',
42
+ setup: function (config, client) {
43
+ browserConfig = config;
44
+ var scope = getGlobalScope();
45
+ if (!(scope === null || scope === void 0 ? void 0 : scope.document))
46
+ return resolved;
47
+ installed = true;
48
+ var doc = scope.document;
49
+ var listen = function (target, type, listener) {
50
+ target.addEventListener(type, listener);
51
+ removeListeners.push(function () { return target.removeEventListener(type, listener); });
52
+ };
53
+ // Register before the engagement tracker so BFCache restore clears the exit guard before resume.
54
+ listen(scope, 'pagehide', function () {
55
+ exited = true;
56
+ cancellation += 1;
57
+ });
58
+ listen(scope, 'pageshow', function () {
59
+ exited = false;
60
+ });
61
+ var trackPageView = function () {
62
+ if (!installed ||
63
+ exited ||
64
+ config.optOut ||
65
+ doc.prerendering ||
66
+ scope.location.href !== pageHref ||
67
+ ((pendingContext === null || pendingContext === void 0 ? void 0 : pendingContext.revision) === revision && pendingContext.cancellation === cancellation))
68
+ return resolved;
69
+ var context = { revision: revision, cancellation: cancellation, href: scope.location.href };
70
+ pendingContext = context;
71
+ // Renew without carrying application properties from the previous view.
72
+ var event = { event_type: secondaryEventType, extra: { engagedTimeContext: context } };
73
+ return client.track(event).promise.finally(function () {
74
+ if (pendingContext === context)
75
+ pendingContext = undefined;
76
+ });
77
+ };
78
+ pageEngagement = createPageEngagement(client, scope, options, config, function () {
79
+ void trackPageView();
80
+ });
81
+ pageEngagement.setOptOut(config.optOut);
82
+ var contextName = '@amplitude/plugin-engaged-time-tracking-browser/context';
83
+ return client
84
+ .add({
85
+ name: contextName,
86
+ type: 'before',
87
+ execute: function (event) {
88
+ var _a, _b, _c, _d;
89
+ // Drop stale generated renewals before page counter/URL enrichment mutates state.
90
+ var context = (_a = event.extra) === null || _a === void 0 ? void 0 : _a.engagedTimeContext;
91
+ if (((_b = event.extra) === null || _b === void 0 ? void 0 : _b.engagedTimeReplay) !== true &&
92
+ (context === null || context === void 0 ? void 0 : context.revision) !== undefined &&
93
+ (context.revision !== revision ||
94
+ context.cancellation !== cancellation ||
95
+ context.href !== scope.location.href))
96
+ return Promise.resolve(null);
97
+ if (((_c = event.extra) === null || _c === void 0 ? void 0 : _c.engagedTimeReplay) !== true && !((_d = event.extra) === null || _d === void 0 ? void 0 : _d.engagedTimeContext)) {
98
+ event.extra = __assign(__assign({}, event.extra), { engagedTimeContext: { cancellation: cancellation, href: scope.location.href } });
99
+ }
100
+ return Promise.resolve(event);
101
+ },
102
+ })
103
+ .promise.then(function () {
104
+ removeContext = function () { return client.remove(contextName).promise; };
105
+ });
106
+ },
107
+ execute: function (event) {
108
+ var _a, _b, _c;
109
+ var context = (_a = event.extra) === null || _a === void 0 ? void 0 : _a.engagedTimeContext;
110
+ if (!pageEngagement ||
111
+ ((_b = event.extra) === null || _b === void 0 ? void 0 : _b.engagedTimeReplay) === true ||
112
+ (event.event_type !== eventType &&
113
+ !(event.event_type === secondaryEventType && (context === null || context === void 0 ? void 0 : context.revision) !== undefined)))
114
+ return Promise.resolve(event);
115
+ if (exited || browserConfig.optOut)
116
+ return Promise.resolve(null);
117
+ if (context && context.cancellation !== cancellation)
118
+ return Promise.resolve(null);
119
+ if ((context === null || context === void 0 ? void 0 : context.revision) !== undefined && context.revision !== revision)
120
+ return Promise.resolve(null);
121
+ if ((context === null || context === void 0 ? void 0 : context.href) !== undefined && context.href !== getGlobalScope().location.href)
122
+ return Promise.resolve(context.revision !== undefined ? null : event);
123
+ pageHref = getGlobalScope().location.href;
124
+ revision += 1;
125
+ return Promise.resolve((_c = pageEngagement.start(event)) !== null && _c !== void 0 ? _c : event);
126
+ },
127
+ teardown: function () {
128
+ var _a;
129
+ installed = false;
130
+ cancellation += 1;
131
+ pageEngagement === null || pageEngagement === void 0 ? void 0 : pageEngagement.teardown();
132
+ pageEngagement = undefined;
133
+ removeListeners.forEach(function (remove) { return remove(); });
134
+ return (_a = removeContext === null || removeContext === void 0 ? void 0 : removeContext()) !== null && _a !== void 0 ? _a : resolved;
135
+ },
136
+ onOptOutChanged: function (optOut) {
137
+ if (optOut) {
138
+ cancellation += 1;
139
+ }
140
+ pageEngagement === null || pageEngagement === void 0 ? void 0 : pageEngagement.setOptOut(optOut);
141
+ return resolved;
142
+ },
143
+ onReset: function () {
144
+ finish('reset');
145
+ return resolved;
146
+ },
147
+ onIdentityChanged: function (identity) {
148
+ if ('userId' in identity || 'deviceId' in identity)
149
+ finish('identity_change');
150
+ return resolved;
151
+ },
152
+ onSessionIdChanged: function () {
153
+ finish('session_change');
154
+ return resolved;
155
+ },
156
+ };
157
+ };
158
+ //# sourceMappingURL=engaged-time-tracking.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engaged-time-tracking.js","sourceRoot":"","sources":["../../src/engaged-time-tracking.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n BrowserClient,\n BrowserConfig,\n DEFAULT_PAGE_VIEW_EVENT,\n EngagedTimeOptions,\n EnrichmentPlugin,\n Event,\n getGlobalScope,\n} from '@amplitude/analytics-core';\nimport { createPageEngagement, PageEngagement } from './page-engagement';\n\n/** Observe configured page views; only idle/lifecycle recovery creates replacement views. */\nexport const engagedTimeTrackingPlugin = (options: EngagedTimeOptions = {}): EnrichmentPlugin => {\n // Exact application PageView event name to observe.\n const eventType = options.pageViewEventType ?? DEFAULT_PAGE_VIEW_EVENT;\n // Generated lifecycle renewals can use a separate analytics event name.\n const secondaryEventType = options.secondaryPageViewEventType ?? eventType;\n // Tracks the current view's elapsed time, activity, and heartbeat.\n let pageEngagement: PageEngagement | undefined;\n // Shared SDK settings, including the current opt-out value.\n let browserConfig: BrowserConfig;\n // Blocks renewal after pagehide until pageshow, including BFCache.\n let exited = false;\n // Prevents this plugin from generating events after teardown.\n let installed = false;\n // URL of the last accepted view; renewal waits on this same URL.\n let pageHref: string | undefined;\n // Invalidates queued events across identity, session, consent, or exit boundaries.\n let cancellation = 0;\n // Advances for each accepted view so an older renewal cannot replace it.\n let revision = 0;\n // Identifies an in-flight renewal to suppress repeated activity/focus requests.\n let pendingContext: { revision: number; cancellation: number } | undefined;\n // Removes the before-plugin that stamps each event's lifecycle context.\n let removeContext: (() => Promise<void>) | undefined;\n // Unsubscribes this plugin's DOM lifecycle listeners during teardown.\n const removeListeners: (() => void)[] = [];\n // Reuses a completed promise for synchronous plugin hooks.\n const resolved = Promise.resolve();\n // Cancels stale queued events and finalizes the active view.\n const finish = (reason: string) => {\n cancellation += 1;\n pageEngagement?.finish(reason);\n };\n\n return {\n name: '@amplitude/plugin-engaged-time-tracking-browser',\n type: 'enrichment',\n setup: (config: BrowserConfig, client: BrowserClient) => {\n browserConfig = config;\n const scope = getGlobalScope();\n if (!scope?.document) return resolved;\n installed = true;\n const doc = scope.document as Document & { prerendering?: boolean };\n const listen = (target: EventTarget, type: string, listener: EventListener) => {\n target.addEventListener(type, listener);\n removeListeners.push(() => target.removeEventListener(type, listener));\n };\n // Register before the engagement tracker so BFCache restore clears the exit guard before resume.\n listen(scope, 'pagehide', () => {\n exited = true;\n cancellation += 1;\n });\n listen(scope, 'pageshow', () => {\n exited = false;\n });\n\n const trackPageView = () => {\n if (\n !installed ||\n exited ||\n config.optOut ||\n doc.prerendering ||\n scope.location.href !== pageHref ||\n (pendingContext?.revision === revision && pendingContext.cancellation === cancellation)\n )\n return resolved;\n const context = { revision, cancellation, href: scope.location.href };\n pendingContext = context;\n // Renew without carrying application properties from the previous view.\n const event: Event = { event_type: secondaryEventType, extra: { engagedTimeContext: context } };\n return client.track(event).promise.finally(() => {\n if (pendingContext === context) pendingContext = undefined;\n });\n };\n pageEngagement = createPageEngagement(client, scope, options, config, () => {\n void trackPageView();\n });\n pageEngagement.setOptOut(config.optOut);\n const contextName = '@amplitude/plugin-engaged-time-tracking-browser/context';\n return client\n .add({\n name: contextName,\n type: 'before',\n execute: (event) => {\n // Drop stale generated renewals before page counter/URL enrichment mutates state.\n const context = event.extra?.engagedTimeContext as typeof pendingContext & { href?: string };\n if (\n event.extra?.engagedTimeReplay !== true &&\n context?.revision !== undefined &&\n (context.revision !== revision ||\n context.cancellation !== cancellation ||\n context.href !== scope.location.href)\n )\n return Promise.resolve(null);\n if (event.extra?.engagedTimeReplay !== true && !event.extra?.engagedTimeContext) {\n event.extra = { ...event.extra, engagedTimeContext: { cancellation, href: scope.location.href } };\n }\n return Promise.resolve(event);\n },\n })\n .promise.then(() => {\n removeContext = () => client.remove(contextName).promise;\n });\n },\n execute: (event) => {\n const context = event.extra?.engagedTimeContext as\n | { cancellation: number; revision?: number; href?: string }\n | undefined;\n if (\n !pageEngagement ||\n event.extra?.engagedTimeReplay === true ||\n (event.event_type !== eventType &&\n !(event.event_type === secondaryEventType && context?.revision !== undefined))\n )\n return Promise.resolve(event);\n if (exited || browserConfig.optOut) return Promise.resolve(null);\n if (context && context.cancellation !== cancellation) return Promise.resolve(null);\n if (context?.revision !== undefined && context.revision !== revision) return Promise.resolve(null);\n if (context?.href !== undefined && context.href !== getGlobalScope()!.location.href)\n return Promise.resolve(context.revision !== undefined ? null : event);\n pageHref = getGlobalScope()!.location.href;\n revision += 1;\n return Promise.resolve(pageEngagement.start(event) ?? event);\n },\n teardown: () => {\n installed = false;\n cancellation += 1;\n pageEngagement?.teardown();\n pageEngagement = undefined;\n removeListeners.forEach((remove) => remove());\n return removeContext?.() ?? resolved;\n },\n onOptOutChanged: (optOut) => {\n if (optOut) {\n cancellation += 1;\n }\n pageEngagement?.setOptOut(optOut);\n return resolved;\n },\n onReset: () => {\n finish('reset');\n return resolved;\n },\n onIdentityChanged: (identity) => {\n if ('userId' in identity || 'deviceId' in identity) finish('identity_change');\n return resolved;\n },\n onSessionIdChanged: () => {\n finish('session_change');\n return resolved;\n },\n };\n};\n"]}
@@ -0,0 +1,2 @@
1
+ export { engagedTimeTrackingPlugin, engagedTimeTrackingPlugin as plugin } from './engaged-time-tracking';
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,IAAI,MAAM,EAAE,MAAM,yBAAyB,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { engagedTimeTrackingPlugin, engagedTimeTrackingPlugin as plugin } from './engaged-time-tracking';
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,IAAI,MAAM,EAAE,MAAM,yBAAyB,CAAC","sourcesContent":["export { engagedTimeTrackingPlugin, engagedTimeTrackingPlugin as plugin } from './engaged-time-tracking';\n"]}
@@ -0,0 +1,15 @@
1
+ import { getGlobalScope, BrowserClient, Event, BrowserConfig, EngagedTimeOptions } from '@amplitude/analytics-core';
2
+ export declare const DEFAULT_ACTIVITY_WINDOW = 5000;
3
+ export declare const DEFAULT_ENGAGEMENT_HEARTBEAT = 15000;
4
+ export declare const DEFAULT_INACTIVITY_TIMEOUT = 180000;
5
+ /** Owns one page-view delay group at a time, independently of the video heartbeat.
6
+ * Keep per-owner state in a closure so ES5 bundles can minify internal names.
7
+ */
8
+ export declare const createPageEngagement: (client: BrowserClient, scope: NonNullable<ReturnType<typeof getGlobalScope>>, options: EngagedTimeOptions, config: BrowserConfig, newPageView: () => void) => {
9
+ start: (event: Event) => Event | undefined;
10
+ finish: (reason: string) => void;
11
+ setOptOut: (optOut: boolean) => void;
12
+ teardown: () => void;
13
+ };
14
+ export type PageEngagement = ReturnType<typeof createPageEngagement>;
15
+ //# sourceMappingURL=page-engagement.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"page-engagement.d.ts","sourceRoot":"","sources":["../../src/page-engagement.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,EAEL,aAAa,EAEb,kBAAkB,EAEnB,MAAM,2BAA2B,CAAC;AAEnC,eAAO,MAAM,uBAAuB,OAAQ,CAAC;AAC7C,eAAO,MAAM,4BAA4B,QAAS,CAAC;AACnD,eAAO,MAAM,0BAA0B,SAAU,CAAC;AAsClD;;GAEG;AACH,eAAO,MAAM,oBAAoB,WACvB,aAAa,SACd,YAAY,WAAW,qBAAqB,CAAC,CAAC,WAC5C,kBAAkB,UACnB,aAAa,eACR,MAAM,IAAI;mBA4BD,KAAK,KAAG,KAAK,GAAG,SAAS;qBAoKvB,MAAM;wBAiBH,OAAO;;CAoCnC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
@@ -0,0 +1,234 @@
1
+ import { __assign } from "tslib";
2
+ import { Heartbeat, UUID, } from '@amplitude/analytics-core';
3
+ export var DEFAULT_ACTIVITY_WINDOW = 5000;
4
+ export var DEFAULT_ENGAGEMENT_HEARTBEAT = 15000;
5
+ export var DEFAULT_INACTIVITY_TIMEOUT = 180000;
6
+ var BACKGROUND_SEND_INTERVAL = 1000;
7
+ // Browser timers use a signed 32-bit millisecond delay. Larger values can overflow.
8
+ var MAX_TIMER_DELAY_MILLIS = 2147483647;
9
+ // The delayed-event service rejects request timeouts greater than 24 hours.
10
+ var MAX_INACTIVITY_TIMEOUT_MILLIS = 86400000;
11
+ function resolveDurationMillis(value, defaultValue, logger, maximum) {
12
+ if (maximum === void 0) { maximum = MAX_TIMER_DELAY_MILLIS; }
13
+ if (value === undefined)
14
+ return defaultValue;
15
+ if (!Number.isFinite(value) || value <= 0 || value > maximum) {
16
+ logger.warn("Page engagement: invalid duration ".concat(value, " ms; using default ").concat(defaultValue, " ms. Expected 0 < finite duration <= ").concat(maximum, " ms."));
17
+ return defaultValue;
18
+ }
19
+ return value;
20
+ }
21
+ /** Owns one page-view delay group at a time, independently of the video heartbeat.
22
+ * Keep per-owner state in a closure so ES5 bundles can minify internal names.
23
+ */
24
+ export var createPageEngagement = function (client, scope, options, config, newPageView) {
25
+ var currentPage;
26
+ var inactivityTimer;
27
+ var foreground = isForeground();
28
+ var enabled = true;
29
+ var skippedPage = false;
30
+ var removeListeners = [];
31
+ var timeout = resolveDurationMillis(options.inactivityTimeoutMillis, DEFAULT_INACTIVITY_TIMEOUT, config.loggerProvider, MAX_INACTIVITY_TIMEOUT_MILLIS);
32
+ var activityWindow = resolveDurationMillis(options.activityWindowMillis, DEFAULT_ACTIVITY_WINDOW, config.loggerProvider);
33
+ var pulse = Math.min(resolveDurationMillis(options.heartbeatIntervalMillis, DEFAULT_ENGAGEMENT_HEARTBEAT, config.loggerProvider), timeout / 2);
34
+ function isForeground() {
35
+ return scope.document.visibilityState === 'visible' && scope.document.hasFocus();
36
+ }
37
+ function start(event) {
38
+ var _a;
39
+ finish('navigation');
40
+ if (!enabled)
41
+ return undefined;
42
+ var now = Date.now();
43
+ foreground = isForeground();
44
+ var pageState = {
45
+ event: __assign(__assign({}, event), {
46
+ // Capture top-level properties; snapshots add timing without mutating this object.
47
+ event_properties: __assign({}, event.event_properties), insert_id: event.insert_id || UUID(), time: (_a = event.time) !== null && _a !== void 0 ? _a : now,
48
+ // Share the SDK inactivity duration with the service fallback. The SDK counts
49
+ // from last activity; the service counts from the last accepted heartbeat.
50
+ delay: { id: UUID(), timeout: timeout } }),
51
+ heartbeat: new Heartbeat(client, pulse, timeout, config.loggerProvider, {
52
+ // This owner settles elapsed time and finalizes before sending.
53
+ // Avoid a second set of lifecycle sends.
54
+ sendOnPageLifecycle: false,
55
+ beforeHeartbeat: function () {
56
+ // A heartbeat scheduled by the previous page must not update the new page state.
57
+ if (currentPage === pageState) {
58
+ if (Date.now() >= pageState.lastActivity + timeout) {
59
+ retire(pageState, 'inactivity');
60
+ }
61
+ else {
62
+ void pageState.heartbeat.update(snapshot(pageState, pageState.nextSnapshotReason));
63
+ pageState.nextSnapshotReason = 'heartbeat';
64
+ }
65
+ }
66
+ },
67
+ }),
68
+ started: now,
69
+ updated: now,
70
+ lastActivity: now,
71
+ engaged: 0,
72
+ version: 0,
73
+ nextSnapshotReason: 'heartbeat',
74
+ };
75
+ // Arrival after server expiry must not overwrite more recent identify updates.
76
+ delete pageState.event.user_properties;
77
+ var initial = snapshot(pageState, 'initial');
78
+ var isEnqueued = false;
79
+ try {
80
+ isEnqueued = pageState.heartbeat.enqueue(initial);
81
+ }
82
+ catch (_b) {
83
+ // Heartbeat's size check serializes the event and can reject invalid source data.
84
+ pageState.heartbeat.stop();
85
+ }
86
+ if (!isEnqueued) {
87
+ // Do not turn subsequent activity on this page into repeated fallback views.
88
+ skippedPage = true;
89
+ config.loggerProvider.warn('Page engagement: snapshot cannot be queued (invalid data or size limit); sending without engaged-time tracking.');
90
+ return undefined;
91
+ }
92
+ currentPage = pageState;
93
+ scheduleInactivity();
94
+ // The original pipeline sends initial. Start only the periodic pulse here;
95
+ // Heartbeat.resetHeartbeat() would send a duplicate initial copy.
96
+ pageState.pulseTimer = setInterval(function () { return void pageState.heartbeat.heartbeat(); }, pulse);
97
+ return initial;
98
+ }
99
+ function settle(pageState) {
100
+ // Cap a late callback at the inactivity deadline; heartbeats never extend it.
101
+ var now = Math.max(pageState.updated, Math.min(Date.now(), pageState.lastActivity + timeout));
102
+ if (foreground) {
103
+ pageState.engaged += Math.max(0, Math.min(now, pageState.lastActivity + activityWindow) - pageState.updated);
104
+ }
105
+ pageState.updated = now;
106
+ }
107
+ function snapshot(pageState, reason) {
108
+ settle(pageState);
109
+ var version = ++pageState.version;
110
+ return __assign(__assign(__assign({}, pageState.event), (reason === 'initial' ? {} : { extra: __assign(__assign({}, pageState.event.extra), { engagedTimeReplay: true }) })), { event_properties: __assign(__assign({}, pageState.event.event_properties), { '[Amplitude] Engaged Time': pageState.engaged, '[Amplitude] Total Time': pageState.updated - pageState.started,
111
+ // Internal diagnostics; version counts constructed snapshots, not requests.
112
+ '[Amplitude] Snapshot Version': version, '[Amplitude] Engagement Snapshot Reason': reason }) });
113
+ }
114
+ function scheduleInactivity() {
115
+ clearTimeout(inactivityTimer);
116
+ inactivityTimer = setTimeout(function () { return finish('inactivity'); }, timeout);
117
+ }
118
+ var activity = function () {
119
+ if (!enabled ||
120
+ skippedPage ||
121
+ !foreground ||
122
+ scope.document.prerendering)
123
+ return;
124
+ if (currentPage && Date.now() >= currentPage.lastActivity + timeout)
125
+ finish('inactivity');
126
+ if (!currentPage) {
127
+ newPageView();
128
+ return;
129
+ }
130
+ settle(currentPage);
131
+ currentPage.lastActivity = Date.now();
132
+ scheduleInactivity();
133
+ };
134
+ var resume = function () {
135
+ if (scope.document.visibilityState !== 'visible')
136
+ return;
137
+ if (currentPage)
138
+ settle(currentPage);
139
+ foreground = true;
140
+ activity();
141
+ };
142
+ var pause = function () {
143
+ if (currentPage)
144
+ settle(currentPage);
145
+ foreground = false;
146
+ if (currentPage) {
147
+ sendBackground(currentPage);
148
+ }
149
+ };
150
+ function sendBackground(pageState) {
151
+ var remaining = pageState.lastBackgroundSent === undefined
152
+ ? 0
153
+ : pageState.lastBackgroundSent + BACKGROUND_SEND_INTERVAL - Date.now();
154
+ if (remaining > 0) {
155
+ // blur and hidden can describe the same transition. Keep a single trailing
156
+ // send at the original deadline, using the latest state when it fires.
157
+ if (pageState.backgroundTimer === undefined) {
158
+ pageState.backgroundTimer = setTimeout(function () {
159
+ pageState.backgroundTimer = undefined;
160
+ sendBackground(pageState);
161
+ }, remaining);
162
+ }
163
+ return;
164
+ }
165
+ clearTimeout(pageState.backgroundTimer);
166
+ pageState.backgroundTimer = undefined;
167
+ pageState.lastBackgroundSent = Date.now();
168
+ pageState.nextSnapshotReason = 'background';
169
+ void pageState.heartbeat.heartbeat();
170
+ client.flush();
171
+ }
172
+ function retire(pageState, reason) {
173
+ clearInterval(pageState.pulseTimer);
174
+ clearTimeout(pageState.backgroundTimer);
175
+ clearTimeout(inactivityTimer);
176
+ var event = snapshot(pageState, reason);
177
+ event.delay = __assign(__assign({}, event.delay), { timeout: undefined });
178
+ void pageState.heartbeat.update(event);
179
+ pageState.heartbeat.pause();
180
+ currentPage = undefined;
181
+ }
182
+ function finish(reason) {
183
+ skippedPage = false;
184
+ var pageState = currentPage;
185
+ if (!pageState)
186
+ return;
187
+ retire(pageState, reason);
188
+ // Enqueue the final copy before clearing this page's heartbeat. Destination
189
+ // coalesces pending snapshots and preserves in-flight ordering by delay ID.
190
+ // Session/identity hooks run before Browser config updates. Defer delivery
191
+ // until that update completes to avoid reentering session creation from track().
192
+ void Promise.resolve().then(function () {
193
+ void pageState.heartbeat.heartbeat();
194
+ // flush() drains the timeline before flushing destination queues.
195
+ client.flush();
196
+ pageState.heartbeat.stop();
197
+ });
198
+ }
199
+ function setOptOut(optOut) {
200
+ enabled = !optOut;
201
+ if (optOut) {
202
+ skippedPage = false;
203
+ clearTimeout(inactivityTimer);
204
+ clearTimeout(currentPage === null || currentPage === void 0 ? void 0 : currentPage.backgroundTimer);
205
+ clearInterval(currentPage === null || currentPage === void 0 ? void 0 : currentPage.pulseTimer);
206
+ currentPage === null || currentPage === void 0 ? void 0 : currentPage.heartbeat.stop();
207
+ currentPage = undefined;
208
+ }
209
+ }
210
+ function teardown() {
211
+ finish('teardown');
212
+ enabled = false;
213
+ removeListeners.forEach(function (remove) { return remove(); });
214
+ }
215
+ var listen = function (target, type, listener) {
216
+ target.addEventListener(type, listener, { passive: true });
217
+ removeListeners.push(function () { return target.removeEventListener(type, listener); });
218
+ };
219
+ ['pointerdown', 'pointermove', 'keydown', 'scroll', 'touchstart', 'wheel'].forEach(function (type) {
220
+ listen(scope.document, type, activity);
221
+ });
222
+ listen(scope, 'focus', resume);
223
+ listen(scope, 'blur', pause);
224
+ listen(scope.document, 'visibilitychange', function () { return (isForeground() ? resume() : pause()); });
225
+ // Leaving the document always ends this view, including entry into BFCache.
226
+ listen(scope, 'pagehide', function () { return finish('pagehide'); });
227
+ listen(scope, 'pageshow', function () {
228
+ // A restored page starts a fresh view through the existing activity path.
229
+ if (isForeground())
230
+ resume();
231
+ });
232
+ return { start: start, finish: finish, setOptOut: setOptOut, teardown: teardown };
233
+ };
234
+ //# sourceMappingURL=page-engagement.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"page-engagement.js","sourceRoot":"","sources":["../../src/page-engagement.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n getGlobalScope,\n BrowserClient,\n Event,\n Heartbeat,\n BrowserConfig,\n ILogger,\n EngagedTimeOptions,\n UUID,\n} from '@amplitude/analytics-core';\n\nexport const DEFAULT_ACTIVITY_WINDOW = 5_000;\nexport const DEFAULT_ENGAGEMENT_HEARTBEAT = 15_000;\nexport const DEFAULT_INACTIVITY_TIMEOUT = 180_000;\nconst BACKGROUND_SEND_INTERVAL = 1_000;\n\ninterface PageState {\n event: Event;\n heartbeat: Heartbeat;\n pulseTimer?: ReturnType<typeof setInterval>;\n started: number;\n updated: number;\n lastActivity: number;\n engaged: number;\n version: number;\n nextSnapshotReason: 'initial' | 'heartbeat' | 'background';\n lastBackgroundSent?: number;\n backgroundTimer?: ReturnType<typeof setTimeout>;\n}\n\n// Browser timers use a signed 32-bit millisecond delay. Larger values can overflow.\nconst MAX_TIMER_DELAY_MILLIS = 2_147_483_647;\n// The delayed-event service rejects request timeouts greater than 24 hours.\nconst MAX_INACTIVITY_TIMEOUT_MILLIS = 86_400_000;\n\nfunction resolveDurationMillis(\n value: number | undefined,\n defaultValue: number,\n logger: ILogger,\n maximum = MAX_TIMER_DELAY_MILLIS,\n): number {\n if (value === undefined) return defaultValue;\n if (!Number.isFinite(value) || value <= 0 || value > maximum) {\n logger.warn(\n `Page engagement: invalid duration ${value} ms; using default ${defaultValue} ms. Expected 0 < finite duration <= ${maximum} ms.`,\n );\n return defaultValue;\n }\n return value;\n}\n\n/** Owns one page-view delay group at a time, independently of the video heartbeat.\n * Keep per-owner state in a closure so ES5 bundles can minify internal names.\n */\nexport const createPageEngagement = (\n client: BrowserClient,\n scope: NonNullable<ReturnType<typeof getGlobalScope>>,\n options: EngagedTimeOptions,\n config: BrowserConfig,\n newPageView: () => void,\n) => {\n let currentPage: PageState | undefined;\n let inactivityTimer: ReturnType<typeof setTimeout> | undefined;\n let foreground = isForeground();\n let enabled = true;\n let skippedPage = false;\n const removeListeners: (() => void)[] = [];\n const timeout = resolveDurationMillis(\n options.inactivityTimeoutMillis,\n DEFAULT_INACTIVITY_TIMEOUT,\n config.loggerProvider,\n MAX_INACTIVITY_TIMEOUT_MILLIS,\n );\n const activityWindow = resolveDurationMillis(\n options.activityWindowMillis,\n DEFAULT_ACTIVITY_WINDOW,\n config.loggerProvider,\n );\n const pulse = Math.min(\n resolveDurationMillis(options.heartbeatIntervalMillis, DEFAULT_ENGAGEMENT_HEARTBEAT, config.loggerProvider),\n timeout / 2,\n );\n\n function isForeground() {\n return scope.document.visibilityState === 'visible' && scope.document.hasFocus();\n }\n\n function start(event: Event): Event | undefined {\n finish('navigation');\n if (!enabled) return undefined;\n const now = Date.now();\n foreground = isForeground();\n const pageState: PageState = {\n event: {\n ...event,\n // Capture top-level properties; snapshots add timing without mutating this object.\n event_properties: { ...event.event_properties },\n insert_id: event.insert_id || UUID(),\n time: event.time ?? now,\n // Share the SDK inactivity duration with the service fallback. The SDK counts\n // from last activity; the service counts from the last accepted heartbeat.\n delay: { id: UUID(), timeout },\n },\n heartbeat: new Heartbeat(client, pulse, timeout, config.loggerProvider, {\n // This owner settles elapsed time and finalizes before sending.\n // Avoid a second set of lifecycle sends.\n sendOnPageLifecycle: false,\n beforeHeartbeat: () => {\n // A heartbeat scheduled by the previous page must not update the new page state.\n if (currentPage === pageState) {\n if (Date.now() >= pageState.lastActivity + timeout) {\n retire(pageState, 'inactivity');\n } else {\n void pageState.heartbeat.update(snapshot(pageState, pageState.nextSnapshotReason));\n pageState.nextSnapshotReason = 'heartbeat';\n }\n }\n },\n }),\n started: now,\n updated: now,\n lastActivity: now,\n engaged: 0,\n version: 0,\n nextSnapshotReason: 'heartbeat',\n };\n // Arrival after server expiry must not overwrite more recent identify updates.\n delete pageState.event.user_properties;\n const initial = snapshot(pageState, 'initial');\n let isEnqueued = false;\n try {\n isEnqueued = pageState.heartbeat.enqueue(initial);\n } catch {\n // Heartbeat's size check serializes the event and can reject invalid source data.\n pageState.heartbeat.stop();\n }\n if (!isEnqueued) {\n // Do not turn subsequent activity on this page into repeated fallback views.\n skippedPage = true;\n config.loggerProvider.warn(\n 'Page engagement: snapshot cannot be queued (invalid data or size limit); sending without engaged-time tracking.',\n );\n return undefined;\n }\n currentPage = pageState;\n scheduleInactivity();\n // The original pipeline sends initial. Start only the periodic pulse here;\n // Heartbeat.resetHeartbeat() would send a duplicate initial copy.\n pageState.pulseTimer = setInterval(() => void pageState.heartbeat.heartbeat(), pulse);\n return initial;\n }\n\n function settle(pageState: PageState) {\n // Cap a late callback at the inactivity deadline; heartbeats never extend it.\n const now = Math.max(pageState.updated, Math.min(Date.now(), pageState.lastActivity + timeout));\n if (foreground) {\n pageState.engaged += Math.max(0, Math.min(now, pageState.lastActivity + activityWindow) - pageState.updated);\n }\n pageState.updated = now;\n }\n\n function snapshot(pageState: PageState, reason: string): Event {\n settle(pageState);\n const version = ++pageState.version;\n return {\n ...pageState.event,\n ...(reason === 'initial' ? {} : { extra: { ...pageState.event.extra, engagedTimeReplay: true } }),\n event_properties: {\n ...pageState.event.event_properties,\n '[Amplitude] Engaged Time': pageState.engaged,\n '[Amplitude] Total Time': pageState.updated - pageState.started,\n // Internal diagnostics; version counts constructed snapshots, not requests.\n '[Amplitude] Snapshot Version': version,\n '[Amplitude] Engagement Snapshot Reason': reason,\n },\n };\n }\n\n function scheduleInactivity() {\n clearTimeout(inactivityTimer);\n inactivityTimer = setTimeout(() => finish('inactivity'), timeout);\n }\n\n const activity = () => {\n if (\n !enabled ||\n skippedPage ||\n !foreground ||\n (scope.document as Document & { prerendering?: boolean }).prerendering\n )\n return;\n if (currentPage && Date.now() >= currentPage.lastActivity + timeout) finish('inactivity');\n if (!currentPage) {\n newPageView();\n return;\n }\n settle(currentPage);\n currentPage.lastActivity = Date.now();\n scheduleInactivity();\n };\n\n const resume = () => {\n if (scope.document.visibilityState !== 'visible') return;\n if (currentPage) settle(currentPage);\n foreground = true;\n activity();\n };\n\n const pause = () => {\n if (currentPage) settle(currentPage);\n foreground = false;\n if (currentPage) {\n sendBackground(currentPage);\n }\n };\n\n function sendBackground(pageState: PageState) {\n const remaining =\n pageState.lastBackgroundSent === undefined\n ? 0\n : pageState.lastBackgroundSent + BACKGROUND_SEND_INTERVAL - Date.now();\n if (remaining > 0) {\n // blur and hidden can describe the same transition. Keep a single trailing\n // send at the original deadline, using the latest state when it fires.\n if (pageState.backgroundTimer === undefined) {\n pageState.backgroundTimer = setTimeout(() => {\n pageState.backgroundTimer = undefined;\n sendBackground(pageState);\n }, remaining);\n }\n return;\n }\n clearTimeout(pageState.backgroundTimer);\n pageState.backgroundTimer = undefined;\n pageState.lastBackgroundSent = Date.now();\n pageState.nextSnapshotReason = 'background';\n void pageState.heartbeat.heartbeat();\n client.flush();\n }\n\n function retire(pageState: PageState, reason: string) {\n clearInterval(pageState.pulseTimer);\n clearTimeout(pageState.backgroundTimer);\n clearTimeout(inactivityTimer);\n const event = snapshot(pageState, reason);\n event.delay = { ...event.delay!, timeout: undefined };\n void pageState.heartbeat.update(event);\n pageState.heartbeat.pause();\n currentPage = undefined;\n }\n\n function finish(reason: string) {\n skippedPage = false;\n const pageState = currentPage;\n if (!pageState) return;\n retire(pageState, reason);\n // Enqueue the final copy before clearing this page's heartbeat. Destination\n // coalesces pending snapshots and preserves in-flight ordering by delay ID.\n // Session/identity hooks run before Browser config updates. Defer delivery\n // until that update completes to avoid reentering session creation from track().\n void Promise.resolve().then(() => {\n void pageState.heartbeat.heartbeat();\n // flush() drains the timeline before flushing destination queues.\n client.flush();\n pageState.heartbeat.stop();\n });\n }\n\n function setOptOut(optOut: boolean) {\n enabled = !optOut;\n if (optOut) {\n skippedPage = false;\n clearTimeout(inactivityTimer);\n clearTimeout(currentPage?.backgroundTimer);\n clearInterval(currentPage?.pulseTimer);\n currentPage?.heartbeat.stop();\n currentPage = undefined;\n }\n }\n\n function teardown() {\n finish('teardown');\n enabled = false;\n removeListeners.forEach((remove) => remove());\n }\n\n const listen = (target: EventTarget, type: string, listener: EventListener) => {\n target.addEventListener(type, listener, { passive: true });\n removeListeners.push(() => target.removeEventListener(type, listener));\n };\n ['pointerdown', 'pointermove', 'keydown', 'scroll', 'touchstart', 'wheel'].forEach((type) => {\n listen(scope.document, type, activity);\n });\n listen(scope, 'focus', resume);\n listen(scope, 'blur', pause);\n listen(scope.document, 'visibilitychange', () => (isForeground() ? resume() : pause()));\n // Leaving the document always ends this view, including entry into BFCache.\n listen(scope, 'pagehide', () => finish('pagehide'));\n listen(scope, 'pageshow', () => {\n // A restored page starts a fresh view through the existing activity path.\n if (isForeground()) resume();\n });\n\n return { start, finish, setOptOut, teardown };\n};\n\nexport type PageEngagement = ReturnType<typeof createPageEngagement>;\n"]}
@@ -0,0 +1 @@
1
+ !function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).amplitude={})}(this,function(e){"use strict";var t=function(){return t=Object.assign||function(e){for(var t,n=1,i=arguments.length;n<i;n++)for(var r in t=arguments[n])Object.prototype.hasOwnProperty.call(t,r)&&(e[r]=t[r]);return e},t.apply(this,arguments)};function n(e,t,n,i){return new(n||(n=Promise))(function(r,o){function a(e){try{s(i.next(e))}catch(e){o(e)}}function u(e){try{s(i.throw(e))}catch(e){o(e)}}function s(e){var t;e.done?r(e.value):(t=e.value,t instanceof n?t:new n(function(e){e(t)})).then(a,u)}s((i=i.apply(e,t||[])).next())})}function i(e,t){var n,i,r,o={label:0,sent:function(){if(1&r[0])throw r[1];return r[1]},trys:[],ops:[]},a=Object.create(("function"==typeof Iterator?Iterator:Object).prototype);return a.next=u(0),a.throw=u(1),a.return=u(2),"function"==typeof Symbol&&(a[Symbol.iterator]=function(){return this}),a;function u(u){return function(s){return function(u){if(n)throw new TypeError("Generator is already executing.");for(;a&&(a=0,u[0]&&(o=0)),o;)try{if(n=1,i&&(r=2&u[0]?i.return:u[0]?i.throw||((r=i.return)&&r.call(i),0):i.next)&&!(r=r.call(i,u[1])).done)return r;switch(i=0,r&&(u=[2&u[0],r.value]),u[0]){case 0:case 1:r=u;break;case 4:return o.label++,{value:u[1],done:!1};case 5:o.label++,i=u[1],u=[0];continue;case 7:u=o.ops.pop(),o.trys.pop();continue;default:if(!(r=o.trys,(r=r.length>0&&r[r.length-1])||6!==u[0]&&2!==u[0])){o=0;continue}if(3===u[0]&&(!r||u[1]>r[0]&&u[1]<r[3])){o.label=u[1];break}if(6===u[0]&&o.label<r[1]){o.label=r[1],r=u;break}if(r&&o.label<r[2]){o.label=r[2],o.ops.push(u);break}r[2]&&o.ops.pop(),o.trys.pop();continue}u=t.call(e,o)}catch(e){u=[6,e],i=0}finally{n=r=0}if(5&u[0])throw u[1];return{value:u[0]?u[1]:void 0,done:!0}}([u,s])}}}function r(e){var t="function"==typeof Symbol&&Symbol.iterator,n=t&&e[t],i=0;if(n)return n.call(e);if(e&&"number"==typeof e.length)return{next:function(){return e&&i>=e.length&&(e=void 0),{value:e&&e[i++],done:!e}}};throw new TypeError(t?"Object is not iterable.":"Symbol.iterator is not defined.")}function o(e,t){var n="function"==typeof Symbol&&e[Symbol.iterator];if(!n)return e;var i,r,o=n.call(e),a=[];try{for(;(void 0===t||t-- >0)&&!(i=o.next()).done;)a.push(i.value)}catch(e){r={error:e}}finally{try{i&&!i.done&&(n=o.return)&&n.call(o)}finally{if(r)throw r.error}}return a}function a(e,t,n){if(n||2===arguments.length)for(var i,r=0,o=t.length;r<o;r++)!i&&r in t||(i||(i=Array.prototype.slice.call(t,0,r)),i[r]=t[r]);return e.concat(i||Array.prototype.slice.call(t))}"function"==typeof SuppressedError&&SuppressedError;var u=function(){var e="ampIntegrationContext";return"undefined"!=typeof globalThis&&void 0!==globalThis[e]?globalThis[e]:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof window?window:"undefined"!=typeof self?self:"undefined"!=typeof global?global:void 0},s=a([],o(Array(256).keys()),!1).map(function(e){return e.toString(16).padStart(2,"0")}),l=function(e){var t,n=u();if(!(null===(t=null==n?void 0:n.crypto)||void 0===t?void 0:t.getRandomValues))return function(e){return e?(e^16*Math.random()>>e/4).toString(16):(String(1e7)+String(-1e3)+String(-4e3)+String(-8e3)+String(-1e11)).replace(/[018]/g,l)}(e);var i=n.crypto.getRandomValues(new Uint8Array(16));return i[6]=15&i[6]|64,i[8]=63&i[8]|128,a([],o(i.entries()),!1).map(function(e){var t=o(e,2),n=t[0],i=t[1];return[4,6,8,10].includes(n)?"-".concat(s[i]):s[i]}).join("")},c=function(){function e(e,t,n,i,r){void 0===r&&(r={}),this.client=e,this.pulse=t,this.delayTimeout=n,this.logger=i,this.options=r,this.interval=null,this.resetPromise=null,this.unsubscribeFunctions=[],this.pageHidePreparers=[],this.events=new Map,this.delayId=l()}return e.prototype.heartbeat=function(e){var t,o;return void 0===e&&(e=!1),n(this,void 0,void 0,function(){var n,a,u,s,l,c,d,v,f,p=this;return i(this,function(i){switch(i.label){case 0:if(null===(o=(t=this.options).beforeHeartbeat)||void 0===o||o.call(t),0===this.events.size)return this.stop(),[2,[]];n=[],a=function(e){var t=e.event_type,i=e.event_properties,r=function(e,t){var n={};for(var i in e)Object.prototype.hasOwnProperty.call(e,i)&&t.indexOf(i)<0&&(n[i]=e[i]);if(null!=e&&"function"==typeof Object.getOwnPropertySymbols){var r=0;for(i=Object.getOwnPropertySymbols(e);r<i.length;r++)t.indexOf(i[r])<0&&Object.prototype.propertyIsEnumerable.call(e,i[r])&&(n[i[r]]=e[i[r]])}return n}(e,["event_type","event_properties"]),o=u.client.track(t,i,r).promise;if(u.isInstantEvent(e)){var a=e.insert_id;o.finally(function(){return p.events.delete(a)})}n.push(o)},u=this;try{for(s=r(this.events.values()),l=s.next();!l.done;l=s.next())c=l.value,a(c)}catch(e){v={error:e}}finally{try{l&&!l.done&&(f=s.return)&&f.call(s)}finally{if(v)throw v.error}}return[4,Promise.all(n)];case 1:return d=i.sent(),e&&this.client.flush(),[2,d]}})})},e.prototype.resetHeartbeat=function(){return n(this,void 0,void 0,function(){var e,t=this;return i(this,function(n){switch(n.label){case 0:return this.resetPromise?[4,this.resetPromise]:[3,2];case 1:case 3:return[2,n.sent()];case 2:return!1!==this.options.sendOnPageLifecycle&&this.setupPageLifecycleListeners(),this.interval&&clearInterval(this.interval),this.interval=setInterval(function(){t.heartbeat()},this.pulse),e=new Promise(function(e){setTimeout(function(){t.resetPromise=null,e(t.heartbeat())},0)}),this.resetPromise=e,[4,e]}})})},e.prototype.setupPageLifecycleListeners=function(){var e=this;if(!(this.unsubscribeFunctions.length>0)){var t=u();if(t&&"function"==typeof t.addEventListener&&t.document){var n=t.document,i=function(t){var n,i;if(!t.persisted){try{for(var u=r(a([],o(e.pageHidePreparers),!1)),s=u.next();!s.done;s=u.next()){(0,s.value)()}}catch(e){n={error:e}}finally{try{s&&!s.done&&(i=u.return)&&i.call(u)}finally{if(n)throw n.error}}e.heartbeat(!0)}},s=function(){"hidden"===n.visibilityState&&e.resetHeartbeat()};t.addEventListener("pagehide",i),n.addEventListener("visibilitychange",s),this.unsubscribeFunctions.push(function(){t.removeEventListener("pagehide",i),n.removeEventListener("visibilitychange",s)})}}},e.prototype.isInstantEvent=function(e){return Boolean(e.insert_id&&!e.delay.timeout)},e.prototype.checkEventSizeLimit=function(e){var t;return!(JSON.stringify(a([],o(this.events.values()),!1)).length>4e4)||(null===(t=this.logger)||void 0===t||t.warn("Heartbeat: events size limit reached, rejecting event with id=".concat(e.insert_id)),e.insert_id&&this.events.delete(e.insert_id),!1)},e.prototype.enqueue=function(e){return!!e.insert_id&&(this.events.set(e.insert_id,t(t({},e),{delay:e.delay||{id:this.delayId,timeout:this.delayTimeout}})),this.checkEventSizeLimit(e))},e.prototype.track=function(e){return n(this,void 0,void 0,function(){return i(this,function(t){switch(t.label){case 0:return e.insert_id?this.enqueue(e)?[4,this.resetHeartbeat()]:[2]:[2,new Error("insert_id is required on events tracked with heartbeat")];case 1:return[2,t.sent().find(function(t){return t.event.insert_id===e.insert_id})]}})})},e.prototype.trackNoDelay=function(e){return n(this,void 0,void 0,function(){return i(this,function(t){return e.delay={id:this.delayId},[2,this.track(e)]})})},e.prototype.update=function(e){return n(this,void 0,void 0,function(){var n;return i(this,function(i){return e.insert_id&&this.events.has(e.insert_id)&&(n=this.events.get(e.insert_id),this.events.set(e.insert_id,t(t({},e),{delay:e.delay||{id:this.delayId,timeout:this.delayTimeout}})),!this.checkEventSizeLimit(e)&&n)?(this.events.set(e.insert_id,n),[2]):[2]})})},e.prototype.beforePageHide=function(e){var t=this;return this.pageHidePreparers.push(e),function(){var n=t.pageHidePreparers.indexOf(e);-1!==n&&t.pageHidePreparers.splice(n,1)}},e.prototype.pause=function(){this.interval&&clearInterval(this.interval),this.interval=null},e.prototype.stop=function(e){void 0===e&&(e=!1),this.pause(),this.events.clear(),this.unsubscribeFunctions.forEach(function(e){return e()}),this.unsubscribeFunctions=[],e&&this.client.flush()},e}();function d(e,t,n,i){return void 0===i&&(i=2147483647),void 0===e?t:!Number.isFinite(e)||e<=0||e>i?(n.warn("Page engagement: invalid duration ".concat(e," ms; using default ").concat(t," ms. Expected 0 < finite duration <= ").concat(i," ms.")),t):e}var v=function(e,n,i,r,o){var a,u,s=m(),v=!0,f=!1,p=[],h=d(i.inactivityTimeoutMillis,18e4,r.loggerProvider,864e5),g=d(i.activityWindowMillis,5e3,r.loggerProvider),y=Math.min(d(i.heartbeatIntervalMillis,15e3,r.loggerProvider),h/2);function m(){return"visible"===n.document.visibilityState&&n.document.hasFocus()}function b(e){var t=Math.max(e.updated,Math.min(Date.now(),e.lastActivity+h));s&&(e.engaged+=Math.max(0,Math.min(t,e.lastActivity+g)-e.updated)),e.updated=t}function w(e,n){b(e);var i=++e.version;return t(t(t({},e.event),"initial"===n?{}:{extra:t(t({},e.event.extra),{engagedTimeReplay:!0})}),{event_properties:t(t({},e.event.event_properties),{"[Amplitude] Engaged Time":e.engaged,"[Amplitude] Total Time":e.updated-e.started,"[Amplitude] Snapshot Version":i,"[Amplitude] Engagement Snapshot Reason":n})})}function T(){clearTimeout(u),u=setTimeout(function(){return k("inactivity")},h)}var x=function(){v&&!f&&s&&!n.document.prerendering&&(a&&Date.now()>=a.lastActivity+h&&k("inactivity"),a?(b(a),a.lastActivity=Date.now(),T()):o())},P=function(){"visible"===n.document.visibilityState&&(a&&b(a),s=!0,x())},S=function(){a&&b(a),s=!1,a&&_(a)};function _(t){var n=void 0===t.lastBackgroundSent?0:t.lastBackgroundSent+1e3-Date.now();n>0?void 0===t.backgroundTimer&&(t.backgroundTimer=setTimeout(function(){t.backgroundTimer=void 0,_(t)},n)):(clearTimeout(t.backgroundTimer),t.backgroundTimer=void 0,t.lastBackgroundSent=Date.now(),t.nextSnapshotReason="background",t.heartbeat.heartbeat(),e.flush())}function O(e,n){clearInterval(e.pulseTimer),clearTimeout(e.backgroundTimer),clearTimeout(u);var i=w(e,n);i.delay=t(t({},i.delay),{timeout:void 0}),e.heartbeat.update(i),e.heartbeat.pause(),a=void 0}function k(t){f=!1;var n=a;n&&(O(n,t),Promise.resolve().then(function(){n.heartbeat.heartbeat(),e.flush(),n.heartbeat.stop()}))}var E=function(e,t,n){e.addEventListener(t,n,{passive:!0}),p.push(function(){return e.removeEventListener(t,n)})};return["pointerdown","pointermove","keydown","scroll","touchstart","wheel"].forEach(function(e){E(n.document,e,x)}),E(n,"focus",P),E(n,"blur",S),E(n.document,"visibilitychange",function(){return m()?P():S()}),E(n,"pagehide",function(){return k("pagehide")}),E(n,"pageshow",function(){m()&&P()}),{start:function(n){var i;if(k("navigation"),v){var o=Date.now();s=m();var u={event:t(t({},n),{event_properties:t({},n.event_properties),insert_id:n.insert_id||l(),time:null!==(i=n.time)&&void 0!==i?i:o,delay:{id:l(),timeout:h}}),heartbeat:new c(e,y,h,r.loggerProvider,{sendOnPageLifecycle:!1,beforeHeartbeat:function(){a===u&&(Date.now()>=u.lastActivity+h?O(u,"inactivity"):(u.heartbeat.update(w(u,u.nextSnapshotReason)),u.nextSnapshotReason="heartbeat"))}}),started:o,updated:o,lastActivity:o,engaged:0,version:0,nextSnapshotReason:"heartbeat"};delete u.event.user_properties;var d=w(u,"initial"),p=!1;try{p=u.heartbeat.enqueue(d)}catch(e){u.heartbeat.stop()}return p?(a=u,T(),u.pulseTimer=setInterval(function(){u.heartbeat.heartbeat()},y),d):(f=!0,void r.loggerProvider.warn("Page engagement: snapshot cannot be queued (invalid data or size limit); sending without engaged-time tracking."))}},finish:k,setOptOut:function(e){v=!e,e&&(f=!1,clearTimeout(u),clearTimeout(null==a?void 0:a.backgroundTimer),clearInterval(null==a?void 0:a.pulseTimer),null==a||a.heartbeat.stop(),a=void 0)},teardown:function(){k("teardown"),v=!1,p.forEach(function(e){return e()})}}},f=function(e){var n,i;void 0===e&&(e={});var r,o,a,s,l,c=null!==(n=e.pageViewEventType)&&void 0!==n?n:"[Amplitude] Page Viewed",d=null!==(i=e.secondaryPageViewEventType)&&void 0!==i?i:c,f=!1,p=!1,h=0,g=0,y=[],m=Promise.resolve(),b=function(e){h+=1,null==r||r.finish(e)};return{name:"@amplitude/plugin-engaged-time-tracking-browser",type:"enrichment",setup:function(n,i){o=n;var c=u();if(!(null==c?void 0:c.document))return m;p=!0;var b=c.document,w=function(e,t,n){e.addEventListener(t,n),y.push(function(){return e.removeEventListener(t,n)})};w(c,"pagehide",function(){f=!0,h+=1}),w(c,"pageshow",function(){f=!1});(r=v(i,c,e,n,function(){!function(){if(!p||f||n.optOut||b.prerendering||c.location.href!==a||(null==s?void 0:s.revision)===g&&s.cancellation===h)return m;var e={revision:g,cancellation:h,href:c.location.href};s=e;var t={event_type:d,extra:{engagedTimeContext:e}};i.track(t).promise.finally(function(){s===e&&(s=void 0)})}()})).setOptOut(n.optOut);var T="@amplitude/plugin-engaged-time-tracking-browser/context";return i.add({name:T,type:"before",execute:function(e){var n,i,r,o,a=null===(n=e.extra)||void 0===n?void 0:n.engagedTimeContext;return!0===(null===(i=e.extra)||void 0===i?void 0:i.engagedTimeReplay)||void 0===(null==a?void 0:a.revision)||a.revision===g&&a.cancellation===h&&a.href===c.location.href?(!0===(null===(r=e.extra)||void 0===r?void 0:r.engagedTimeReplay)||(null===(o=e.extra)||void 0===o?void 0:o.engagedTimeContext)||(e.extra=t(t({},e.extra),{engagedTimeContext:{cancellation:h,href:c.location.href}})),Promise.resolve(e)):Promise.resolve(null)}}).promise.then(function(){l=function(){return i.remove(T).promise}})},execute:function(e){var t,n,i,s=null===(t=e.extra)||void 0===t?void 0:t.engagedTimeContext;return r&&!0!==(null===(n=e.extra)||void 0===n?void 0:n.engagedTimeReplay)&&(e.event_type===c||e.event_type===d&&void 0!==(null==s?void 0:s.revision))?f||o.optOut||s&&s.cancellation!==h||void 0!==(null==s?void 0:s.revision)&&s.revision!==g?Promise.resolve(null):void 0!==(null==s?void 0:s.href)&&s.href!==u().location.href?Promise.resolve(void 0!==s.revision?null:e):(a=u().location.href,g+=1,Promise.resolve(null!==(i=r.start(e))&&void 0!==i?i:e)):Promise.resolve(e)},teardown:function(){var e;return p=!1,h+=1,null==r||r.teardown(),r=void 0,y.forEach(function(e){return e()}),null!==(e=null==l?void 0:l())&&void 0!==e?e:m},onOptOutChanged:function(e){return e&&(h+=1),null==r||r.setOptOut(e),m},onReset:function(){return b("reset"),m},onIdentityChanged:function(e){return("userId"in e||"deviceId"in e)&&b("identity_change"),m},onSessionIdChanged:function(){return b("session_change"),m}}};e.engagedTimeTrackingPlugin=f,e.plugin=f,Object.defineProperty(e,"__esModule",{value:!0})});
@@ -0,0 +1,4 @@
1
+ import { EngagedTimeOptions, EnrichmentPlugin } from '@amplitude/analytics-core';
2
+ /** Observe configured page views; only idle/lifecycle recovery creates replacement views. */
3
+ export declare const engagedTimeTrackingPlugin: (options?: EngagedTimeOptions) => EnrichmentPlugin;
4
+ //# sourceMappingURL=engaged-time-tracking.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"engaged-time-tracking.d.ts","sourceRoot":"","sources":["../../src/engaged-time-tracking.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,kBAAkB,EAClB,gBAAgB,EAGjB,MAAM,2BAA2B,CAAC;AAGnC,6FAA6F;AAC7F,eAAO,MAAM,yBAAyB,aAAa,kBAAkB,KAAQ,gBAuJ5E,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { engagedTimeTrackingPlugin, engagedTimeTrackingPlugin as plugin } from './engaged-time-tracking';
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,yBAAyB,IAAI,MAAM,EAAE,MAAM,yBAAyB,CAAC"}