@amplitude/plugin-page-view-tracking-browser 2.12.0-codexsemantic-review-integration.0 → 2.12.0-video-analytics-8.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.
@@ -1 +1 @@
1
- {"version":3,"file":"page-view-tracking.js","sourceRoot":"","sources":["../../src/page-view-tracking.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n getPageTitle,\n replaceSensitiveString,\n BrowserConfig,\n BrowserClient,\n EnrichmentPlugin,\n Event,\n IdentifyOperation,\n IdentifyUserProperties,\n ILogger,\n CampaignParser,\n getGlobalScope,\n BASE_CAMPAIGN,\n BrowserStorage,\n omitUndefined,\n getCurrentPageViewId,\n getOrCreatePageViewId,\n AMPLITUDE_EVENT_PROP_SDK_INITIALIZATION_OFFSET,\n getSdkInitializationOffset,\n} from '@amplitude/analytics-core';\nimport { CreatePageViewTrackingPlugin, Options } from './typings/page-view-tracking';\n\nexport const defaultPageViewEvent = '[Amplitude] Page Viewed';\nexport { PAGE_VIEW_SESSION_STORAGE_KEY } from '@amplitude/analytics-core';\n\ntype PageViewSessionStorage = {\n pageViewId: string;\n};\n\nexport const pageViewTrackingPlugin: CreatePageViewTrackingPlugin = (options: Options = {}) => {\n let amplitude: BrowserClient | undefined;\n const globalScope = getGlobalScope();\n let loggerProvider: ILogger | undefined = undefined;\n let isTracking = false;\n let localConfig: BrowserConfig;\n let sessionStorage: BrowserStorage<PageViewSessionStorage> | undefined;\n const { trackOn, trackHistoryChanges, eventType = defaultPageViewEvent } = options;\n\n const getDecodeURI = (locationStr: string): string => {\n let decodedLocationStr = locationStr;\n try {\n decodedLocationStr = decodeURI(locationStr);\n } catch (e) {\n /* istanbul ignore next */\n loggerProvider?.error('Malformed URI sequence: ', e);\n }\n\n return decodedLocationStr;\n };\n\n const createPageViewEvent = async (pageViewId: string | undefined): Promise<Event> => {\n // Scroll and viewport are read before the campaign await so a later change stays off this event.\n // The init offset was sampled when the plugin was installed, so this read does not move it.\n const minPageY = readMinPageY();\n const viewportWidth = readViewportWidth();\n const sdkInitializationOffset = getSdkInitializationOffset(localConfig.apiKey);\n /* istanbul ignore next */\n const locationHREF = getDecodeURI((typeof location !== 'undefined' && location.href) || '');\n return {\n event_type: eventType,\n event_properties: {\n ...(await getCampaignParams()),\n '[Amplitude] Page Domain':\n /* istanbul ignore next */ (typeof location !== 'undefined' && location.hostname) || '',\n '[Amplitude] Page Location': locationHREF,\n '[Amplitude] Page Path':\n /* istanbul ignore next */ (typeof location !== 'undefined' && getDecodeURI(location.pathname)) || '',\n '[Amplitude] Page Title': /* istanbul ignore next */ getPageTitle(replaceSensitiveString),\n '[Amplitude] Page URL': locationHREF.split('?')[0],\n '[Amplitude] Min Page Y': minPageY,\n '[Amplitude] Viewport Width': viewportWidth,\n [AMPLITUDE_EVENT_PROP_SDK_INITIALIZATION_OFFSET]: sdkInitializationOffset,\n '[Amplitude] Page View ID': pageViewId,\n },\n };\n };\n\n const shouldTrackOnPageLoad = () => typeof trackOn === 'undefined' || (typeof trackOn === 'function' && trackOn());\n\n /* istanbul ignore next */\n let previousURL: string | null = typeof location !== 'undefined' ? location.href : null;\n\n const trackHistoryPageView = async (): Promise<void> => {\n const newURL = location.href;\n const shouldTrackPageView =\n shouldTrackHistoryPageView(trackHistoryChanges, newURL, previousURL || '') && shouldTrackOnPageLoad();\n // Note: Update `previousURL` in the same clock tick as `shouldTrackHistoryPageView()`\n // This was previously done after `amplitude?.track(await createPageViewEvent());` and\n // causes a concurrency issue where app triggers `pushState` twice with the same URL target\n // but `previousURL` is only updated after the second `pushState` producing two page viewed events\n previousURL = newURL;\n\n if (shouldTrackPageView) {\n // Reuse the id already minted for this project and URL, if another SDK instance\n // initialized first. Otherwise mint one and publish it for autocapture.\n let pageViewId: string | undefined;\n if (sessionStorage) {\n pageViewId = getOrCreatePageViewId(localConfig.apiKey, currentHref());\n }\n\n /* istanbul ignore next */\n loggerProvider?.log('Tracking page view event');\n amplitude?.track(await createPageViewEvent(pageViewId));\n }\n };\n\n /* istanbul ignore next */\n const handlePageChange = () => {\n void trackHistoryPageView();\n };\n\n const plugin: EnrichmentPlugin = {\n name: '@amplitude/plugin-page-view-tracking-browser',\n type: 'enrichment',\n\n setup: async (config: BrowserConfig, client: BrowserClient) => {\n amplitude = client;\n localConfig = config;\n\n loggerProvider = config.loggerProvider;\n loggerProvider.log('Installing @amplitude/plugin-page-view-tracking-browser');\n\n isTracking = true;\n // Freeze the navigation-to-init offset now, including when the first page view is deferred.\n getSdkInitializationOffset(localConfig.apiKey);\n if (globalScope) {\n // init session storage\n try {\n sessionStorage = new BrowserStorage<PageViewSessionStorage>(globalScope.sessionStorage);\n } catch (error) {\n /* istanbul ignore next */\n loggerProvider?.debug('sessionStorage is not available in this environment.');\n }\n\n globalScope.addEventListener('popstate', handlePageChange);\n\n /* istanbul ignore next */\n // There is no global browser listener for changes to history, so we have\n // to modify pushState directly.\n // https://stackoverflow.com/a/64927639\n // eslint-disable-next-line @typescript-eslint/unbound-method\n globalScope.history.pushState = new Proxy(globalScope.history.pushState, {\n apply: (target, thisArg, [state, unused, url]) => {\n target.apply(thisArg, [state, unused, url]);\n if (isTracking) {\n handlePageChange();\n }\n },\n });\n }\n\n if (shouldTrackOnPageLoad()) {\n loggerProvider.log('Tracking page view event');\n // Reuse the id already minted for this project and URL, if another SDK instance\n // initialized first. Otherwise mint one and publish it for autocapture.\n let pageViewId: string | undefined;\n\n if (sessionStorage) {\n pageViewId = getOrCreatePageViewId(localConfig.apiKey, currentHref());\n }\n\n amplitude.track(await createPageViewEvent(pageViewId));\n }\n },\n\n execute: async (event: Event) => {\n if (trackOn === 'attribution' && isCampaignEvent(event)) {\n /* istanbul ignore next */ // loggerProvider should be defined by the time execute is invoked\n loggerProvider?.log('Enriching campaign event to page view event with campaign parameters');\n // Retrieve the current page view id. Do not mint a new one for attribution.\n let pageViewId: string | undefined;\n if (sessionStorage) {\n pageViewId = getCurrentPageViewId(localConfig.apiKey);\n }\n\n const pageViewEvent = await createPageViewEvent(pageViewId);\n event.event_type = pageViewEvent.event_type;\n event.event_properties = {\n ...event.event_properties,\n ...pageViewEvent.event_properties,\n };\n }\n\n // Update the pageCounter for the page view event\n if (localConfig && event.event_type === eventType) {\n localConfig.pageCounter = !localConfig.pageCounter ? 1 : localConfig.pageCounter + 1;\n event.event_properties = {\n ...event.event_properties,\n '[Amplitude] Page Counter': localConfig.pageCounter,\n };\n }\n return event;\n },\n\n teardown: async () => {\n if (globalScope) {\n globalScope.removeEventListener('popstate', handlePageChange);\n isTracking = false;\n }\n },\n };\n return plugin;\n};\n\n/* istanbul ignore next */\nconst currentHref = (): string => (typeof location !== 'undefined' && location.href) || '';\n\n/** Top of the viewport (`scrollY`) when the page view event is created. */\nconst readMinPageY = (): number => {\n const scope = getGlobalScope();\n if (!scope) {\n return 0;\n }\n const offset = scope.scrollY ?? scope.pageYOffset ?? 0;\n return Math.floor(offset);\n};\n\n/** `window.innerWidth` when the page view event is created. Same property as other autocapture events. */\nconst readViewportWidth = (): number => {\n const scope = getGlobalScope();\n if (!scope) {\n return 0;\n }\n return scope.innerWidth ?? 0;\n};\n\nconst getCampaignParams = async () => omitUndefined(await new CampaignParser().parse());\n\nconst isCampaignEvent = (event: Event) => {\n if (event.event_type === '$identify' && event.user_properties) {\n const properties = event.user_properties as IdentifyUserProperties;\n const $set = properties[IdentifyOperation.SET] || {};\n const $unset = properties[IdentifyOperation.UNSET] || {};\n const userProperties = [...Object.keys($set), ...Object.keys($unset)];\n return Object.keys(BASE_CAMPAIGN).every((value) => userProperties.includes(value));\n }\n return false;\n};\n\nexport const shouldTrackHistoryPageView = (\n trackingOption: Options['trackHistoryChanges'],\n newURLStr: string,\n oldURLStr: string,\n): boolean => {\n switch (trackingOption) {\n case 'pathOnly': {\n if (oldURLStr == '') return true;\n const newURL = new URL(newURLStr);\n const oldURL = new URL(oldURLStr);\n const newBaseStr = newURL.origin + newURL.pathname;\n const oldBaseStr = oldURL.origin + oldURL.pathname;\n return newBaseStr !== oldBaseStr;\n }\n default:\n return newURLStr !== oldURLStr;\n }\n};\n"]}
1
+ {"version":3,"file":"page-view-tracking.js","sourceRoot":"","sources":["../../src/page-view-tracking.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n getPageTitle,\n replaceSensitiveString,\n BrowserConfig,\n BrowserClient,\n EnrichmentPlugin,\n Event,\n IdentifyOperation,\n IdentifyUserProperties,\n ILogger,\n CampaignParser,\n getGlobalScope,\n BASE_CAMPAIGN,\n BrowserStorage,\n omitUndefined,\n getCurrentPageViewId,\n getOrCreatePageViewId,\n AMPLITUDE_EVENT_PROP_SDK_INITIALIZATION_OFFSET,\n getSdkInitializationOffset,\n} from '@amplitude/analytics-core';\nimport { CreatePageViewTrackingPlugin, Options } from './typings/page-view-tracking';\nimport { PageEngagement } from './page-engagement';\n\nexport const defaultPageViewEvent = '[Amplitude] Page Viewed';\nexport { PAGE_VIEW_SESSION_STORAGE_KEY } from '@amplitude/analytics-core';\n\ntype PageViewSessionStorage = {\n pageViewId: string;\n};\n\nexport const pageViewTrackingPlugin: CreatePageViewTrackingPlugin = (options: Options = {}) => {\n let amplitude: BrowserClient | undefined;\n const globalScope = getGlobalScope();\n let loggerProvider: ILogger | undefined = undefined;\n let isTracking = false;\n let localConfig: BrowserConfig;\n let sessionStorage: BrowserStorage<PageViewSessionStorage> | undefined;\n let engagement: PageEngagement | undefined;\n let lastPageViewId: string | undefined;\n let pendingPageRevision: number | undefined;\n let cancellationRevision = 0;\n let pageRevision = 0;\n let pageHasExited = false;\n let removePrerenderListener: (() => void) | undefined;\n let removePageLifecycleListeners: (() => void) | undefined;\n const { trackOn, trackHistoryChanges, eventType = defaultPageViewEvent } = options;\n\n const getDecodeURI = (locationStr: string): string => {\n let decodedLocationStr = locationStr;\n try {\n decodedLocationStr = decodeURI(locationStr);\n } catch (e) {\n /* istanbul ignore next */\n loggerProvider?.error('Malformed URI sequence: ', e);\n }\n\n return decodedLocationStr;\n };\n\n const createPageViewEvent = async (pageViewId: string | undefined): Promise<Event> => {\n // Scroll and viewport are read before the campaign await so a later change stays off this event.\n // The init offset was sampled when the plugin was installed, so this read does not move it.\n const minPageY = readMinPageY();\n const viewportWidth = readViewportWidth();\n const sdkInitializationOffset = getSdkInitializationOffset(localConfig.apiKey);\n /* istanbul ignore next */\n const locationHREF = getDecodeURI((typeof location !== 'undefined' && location.href) || '');\n // Capture the page before campaign lookup yields to a later navigation.\n const pageProperties = {\n '[Amplitude] Page Domain':\n /* istanbul ignore next */ (typeof location !== 'undefined' && location.hostname) || '',\n '[Amplitude] Page Location': locationHREF,\n '[Amplitude] Page Path':\n /* istanbul ignore next */ (typeof location !== 'undefined' && getDecodeURI(location.pathname)) || '',\n '[Amplitude] Page Title': /* istanbul ignore next */ getPageTitle(replaceSensitiveString),\n '[Amplitude] Page URL': locationHREF.split('?')[0],\n '[Amplitude] Min Page Y': minPageY,\n '[Amplitude] Viewport Width': viewportWidth,\n [AMPLITUDE_EVENT_PROP_SDK_INITIALIZATION_OFFSET]: sdkInitializationOffset,\n '[Amplitude] Page View ID': pageViewId,\n };\n return {\n event_type: eventType,\n event_properties: { ...(await getCampaignParams()), ...pageProperties },\n };\n };\n\n const shouldTrackOnPageLoad = () => typeof trackOn === 'undefined' || (typeof trackOn === 'function' && trackOn());\n\n const trackNewPageView = async (client: BrowserClient) => {\n const revision = pageRevision;\n const cancellation = cancellationRevision;\n if (pageHasExited || pendingPageRevision === revision) return;\n pendingPageRevision = revision;\n const pageViewId = getOrCreatePageViewId(localConfig.apiKey, currentHref(), lastPageViewId);\n lastPageViewId = pageViewId;\n try {\n const event = await createPageViewEvent(pageViewId);\n if (isTracking && !localConfig.optOut && cancellation === cancellationRevision) {\n event.extra = { ...event.extra, pageViewContext: { revision, cancellation } };\n // Keep the guard until the event reaches execute(), not just until it is queued.\n await client.track(event).promise;\n }\n } finally {\n if (pendingPageRevision === revision) pendingPageRevision = undefined;\n }\n };\n\n // Navigation preserves pending views as ordinary events. Identity/session\n // boundaries still cancel them so they cannot be attributed to a later context.\n const finishPageView = (reason: string) => {\n pageRevision += 1;\n if (reason !== 'navigation') cancellationRevision += 1;\n engagement?.finish(reason);\n };\n\n /* istanbul ignore next */\n let previousURL: string | null = typeof location !== 'undefined' ? location.href : null;\n\n const trackHistoryPageView = async (): Promise<void> => {\n const newURL = location.href;\n const isNewPage = shouldTrackHistoryPageView(trackHistoryChanges, newURL, previousURL || '');\n const shouldTrackPageView = isNewPage && shouldTrackOnPageLoad();\n // Note: Update `previousURL` in the same clock tick as `shouldTrackHistoryPageView()`\n // This was previously done after `amplitude?.track(await createPageViewEvent());` and\n // causes a concurrency issue where app triggers `pushState` twice with the same URL target\n // but `previousURL` is only updated after the second `pushState` producing two page viewed events\n previousURL = newURL;\n\n if (engagement && isNewPage) {\n // Navigation ends engagement; pending views retain their original page.\n finishPageView('navigation');\n }\n if (shouldTrackPageView) {\n if (engagement) {\n void trackNewPageView(amplitude!);\n return;\n }\n // Generate new page view id and set it in session storage\n let pageViewId: string | undefined;\n if (sessionStorage) {\n pageViewId = getOrCreatePageViewId(localConfig.apiKey, currentHref());\n }\n\n /* istanbul ignore next */\n loggerProvider?.log('Tracking page view event');\n amplitude?.track(await createPageViewEvent(pageViewId));\n }\n };\n\n /* istanbul ignore next */\n const handlePageChange = () => {\n void trackHistoryPageView();\n };\n\n const plugin: EnrichmentPlugin = {\n name: '@amplitude/plugin-page-view-tracking-browser',\n type: 'enrichment',\n\n setup: async (config: BrowserConfig, client: BrowserClient) => {\n amplitude = client;\n localConfig = config;\n\n loggerProvider = config.loggerProvider;\n loggerProvider.log('Installing @amplitude/plugin-page-view-tracking-browser');\n\n isTracking = true;\n if (options.trackEngagedTime && trackOn === undefined && globalScope?.document) {\n // Invalidate pending creations before the engagement owner handles these events.\n const onPageHide = () => {\n pageHasExited = true;\n pageRevision += 1;\n cancellationRevision += 1;\n };\n const onPageShow = () => {\n pageHasExited = false;\n };\n globalScope.addEventListener('pagehide', onPageHide);\n globalScope.addEventListener('pageshow', onPageShow);\n removePageLifecycleListeners = () => {\n globalScope.removeEventListener('pagehide', onPageHide);\n globalScope.removeEventListener('pageshow', onPageShow);\n };\n const engagementOptions = typeof options.trackEngagedTime === 'object' ? options.trackEngagedTime : {};\n engagement = new PageEngagement(client, globalScope, engagementOptions, config, () => {\n void trackNewPageView(client);\n });\n }\n // Freeze the navigation-to-init offset now, including when the first page view is deferred.\n getSdkInitializationOffset(localConfig.apiKey);\n if (globalScope) {\n // init session storage\n try {\n sessionStorage = new BrowserStorage<PageViewSessionStorage>(globalScope.sessionStorage);\n } catch (error) {\n /* istanbul ignore next */\n loggerProvider?.debug('sessionStorage is not available in this environment.');\n }\n\n globalScope.addEventListener('popstate', handlePageChange);\n\n /* istanbul ignore next */\n // There is no global browser listener for changes to history, so we have\n // to modify pushState directly.\n // https://stackoverflow.com/a/64927639\n // eslint-disable-next-line @typescript-eslint/unbound-method\n globalScope.history.pushState = new Proxy(globalScope.history.pushState, {\n apply: (target, thisArg, [state, unused, url]) => {\n target.apply(thisArg, [state, unused, url]);\n if (isTracking) {\n handlePageChange();\n }\n },\n });\n }\n\n if (shouldTrackOnPageLoad()) {\n // An engagement owner is only installed in a document environment.\n const doc = globalScope?.document as (Document & { prerendering?: boolean }) | undefined;\n if (doc && engagement && doc.prerendering) {\n const onActivated = () => {\n doc.removeEventListener('prerenderingchange', onActivated);\n void trackNewPageView(client);\n };\n doc.addEventListener('prerenderingchange', onActivated);\n removePrerenderListener = () => doc.removeEventListener('prerenderingchange', onActivated);\n return;\n }\n if (engagement) {\n void trackNewPageView(client);\n return;\n }\n loggerProvider.log('Tracking page view event');\n // Reuse the id already minted for this project and URL, if another SDK instance\n // initialized first. Otherwise mint one and publish it for autocapture.\n let pageViewId: string | undefined;\n\n if (sessionStorage) {\n pageViewId = getOrCreatePageViewId(localConfig.apiKey, currentHref());\n }\n\n amplitude.track(await createPageViewEvent(pageViewId));\n }\n },\n\n execute: async (event: Event) => {\n // A heartbeat reuses the enriched original page view, including its counter.\n if (engagement && event.delay) return event;\n if (trackOn === 'attribution' && isCampaignEvent(event)) {\n /* istanbul ignore next */ // loggerProvider should be defined by the time execute is invoked\n loggerProvider?.log('Enriching campaign event to page view event with campaign parameters');\n // Retrieve the current page view id. Do not mint a new one for attribution.\n let pageViewId: string | undefined;\n if (sessionStorage) {\n pageViewId = getCurrentPageViewId(localConfig.apiKey);\n }\n\n const pageViewEvent = await createPageViewEvent(pageViewId);\n event.event_type = pageViewEvent.event_type;\n event.event_properties = {\n ...event.event_properties,\n ...pageViewEvent.event_properties,\n };\n }\n\n // Update the pageCounter for the page view event\n if (localConfig && event.event_type === eventType) {\n const context = event.extra?.pageViewContext as { revision: number; cancellation: number } | undefined;\n if (engagement && (pageHasExited || (context && context.cancellation !== cancellationRevision))) return null;\n localConfig.pageCounter = !localConfig.pageCounter ? 1 : localConfig.pageCounter + 1;\n event.event_properties = {\n ...event.event_properties,\n '[Amplitude] Page Counter': localConfig.pageCounter,\n };\n if (engagement) {\n if (localConfig.optOut) return null;\n // The page view still happened, but its page has already ended.\n // Send it normally without starting or replacing the current engagement.\n if (context && context.revision !== pageRevision) return event;\n // Delayed page views must never replay user-property updates. Use identify separately.\n delete event.user_properties;\n // Suppress the original only after the heartbeat accepts its snapshot.\n return engagement.start(event) ? null : event;\n }\n }\n return event;\n },\n\n teardown: async () => {\n pageRevision += 1;\n cancellationRevision += 1;\n engagement?.teardown();\n removePrerenderListener?.();\n removePageLifecycleListeners?.();\n if (globalScope) {\n globalScope.removeEventListener('popstate', handlePageChange);\n isTracking = false;\n }\n },\n onOptOutChanged: async (optOut) => {\n if (optOut) {\n pageRevision += 1;\n cancellationRevision += 1;\n }\n engagement?.setOptOut(optOut);\n },\n onReset: async () => finishPageView('reset'),\n onIdentityChanged: async (identity) => {\n if ('userId' in identity || 'deviceId' in identity) finishPageView('identity_change');\n },\n onSessionIdChanged: async () => finishPageView('session_change'),\n };\n return plugin;\n};\n\n/* istanbul ignore next */\nconst currentHref = (): string => (typeof location !== 'undefined' && location.href) || '';\n\n/** Top of the viewport (`scrollY`) when the page view event is created. */\nconst readMinPageY = (): number => {\n const scope = getGlobalScope();\n if (!scope) {\n return 0;\n }\n const offset = scope.scrollY ?? scope.pageYOffset ?? 0;\n return Math.floor(offset);\n};\n\n/** `window.innerWidth` when the page view event is created. Same property as other autocapture events. */\nconst readViewportWidth = (): number => {\n const scope = getGlobalScope();\n if (!scope) {\n return 0;\n }\n return scope.innerWidth ?? 0;\n};\n\nconst getCampaignParams = async () => omitUndefined(await new CampaignParser().parse());\n\nconst isCampaignEvent = (event: Event) => {\n if (event.event_type === '$identify' && event.user_properties) {\n const properties = event.user_properties as IdentifyUserProperties;\n const $set = properties[IdentifyOperation.SET] || {};\n const $unset = properties[IdentifyOperation.UNSET] || {};\n const userProperties = [...Object.keys($set), ...Object.keys($unset)];\n return Object.keys(BASE_CAMPAIGN).every((value) => userProperties.includes(value));\n }\n return false;\n};\n\nexport const shouldTrackHistoryPageView = (\n trackingOption: Options['trackHistoryChanges'],\n newURLStr: string,\n oldURLStr: string,\n): boolean => {\n switch (trackingOption) {\n case 'pathOnly': {\n if (oldURLStr == '') return true;\n const newURL = new URL(newURLStr);\n const oldURL = new URL(oldURLStr);\n const newBaseStr = newURL.origin + newURL.pathname;\n const oldBaseStr = oldURL.origin + oldURL.pathname;\n return newBaseStr !== oldBaseStr;\n }\n default:\n return newURLStr !== oldURLStr;\n }\n};\n"]}
@@ -0,0 +1,35 @@
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
+ export declare class PageEngagement {
7
+ private client;
8
+ private scope;
9
+ private config;
10
+ private newPageView;
11
+ private pageState?;
12
+ private inactivityTimer?;
13
+ private foreground;
14
+ private enabled;
15
+ private skippedPage;
16
+ private readonly activityWindow;
17
+ private readonly pulse;
18
+ private readonly timeout;
19
+ private readonly removeListeners;
20
+ constructor(client: BrowserClient, scope: NonNullable<ReturnType<typeof getGlobalScope>>, options: EngagedTimeOptions, config: BrowserConfig, newPageView: () => void);
21
+ private isForeground;
22
+ start(event: Event): boolean;
23
+ private settle;
24
+ private snapshot;
25
+ private scheduleInactivity;
26
+ private activity;
27
+ private resume;
28
+ private pause;
29
+ private sendBackground;
30
+ private retire;
31
+ finish(reason: string): void;
32
+ setOptOut(optOut: boolean): void;
33
+ teardown(): void;
34
+ }
35
+ //# 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;AAqClD,sFAAsF;AACtF,qBAAa,cAAc;IAYvB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,KAAK;IAEb,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,WAAW;IAfrB,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,eAAe,CAAC,CAAgC;IACxD,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAsB;gBAG5C,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,EAC7D,OAAO,EAAE,kBAAkB,EACnB,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,IAAI;IAoCjC,OAAO,CAAC,YAAY;IAIpB,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;IAsD5B,OAAO,CAAC,MAAM;IASd,OAAO,CAAC,QAAQ;IAiBhB,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,QAAQ,CAgBd;IAEF,OAAO,CAAC,MAAM,CAKZ;IAEF,OAAO,CAAC,KAAK,CAMX;IAEF,OAAO,CAAC,cAAc;IAwBtB,OAAO,CAAC,MAAM;IAUd,MAAM,CAAC,MAAM,EAAE,MAAM;IAarB,SAAS,CAAC,MAAM,EAAE,OAAO;IAWzB,QAAQ;CAKT"}
@@ -0,0 +1,235 @@
1
+ import { __assign, __values } 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: duration ".concat(value, " ms is invalid; using default ").concat(defaultValue, " ms. Expected a finite value greater than 0 and at most ").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
+ var PageEngagement = /** @class */ (function () {
23
+ function PageEngagement(client, scope, options, config, newPageView) {
24
+ var e_1, _a;
25
+ var _this = this;
26
+ this.client = client;
27
+ this.scope = scope;
28
+ this.config = config;
29
+ this.newPageView = newPageView;
30
+ this.enabled = true;
31
+ this.skippedPage = false;
32
+ this.removeListeners = [];
33
+ this.activity = function () {
34
+ if (!_this.enabled ||
35
+ _this.skippedPage ||
36
+ !_this.foreground ||
37
+ _this.scope.document.prerendering)
38
+ return;
39
+ if (_this.pageState && Date.now() >= _this.pageState.lastActivity + _this.timeout)
40
+ _this.finish('inactivity');
41
+ if (!_this.pageState) {
42
+ _this.newPageView();
43
+ return;
44
+ }
45
+ _this.settle(_this.pageState);
46
+ _this.pageState.lastActivity = Date.now();
47
+ _this.scheduleInactivity();
48
+ };
49
+ this.resume = function () {
50
+ if (_this.scope.document.visibilityState !== 'visible')
51
+ return;
52
+ if (_this.pageState)
53
+ _this.settle(_this.pageState);
54
+ _this.foreground = true;
55
+ _this.activity();
56
+ };
57
+ this.pause = function () {
58
+ if (_this.pageState)
59
+ _this.settle(_this.pageState);
60
+ _this.foreground = false;
61
+ if (_this.pageState) {
62
+ _this.sendBackground(_this.pageState);
63
+ }
64
+ };
65
+ this.timeout = resolveDurationMillis(options.inactivityTimeoutMillis, DEFAULT_INACTIVITY_TIMEOUT, config.loggerProvider, MAX_INACTIVITY_TIMEOUT_MILLIS);
66
+ this.activityWindow = resolveDurationMillis(options.activityWindowMillis, DEFAULT_ACTIVITY_WINDOW, config.loggerProvider);
67
+ this.pulse = Math.min(resolveDurationMillis(options.heartbeatIntervalMillis, DEFAULT_ENGAGEMENT_HEARTBEAT, config.loggerProvider), this.timeout / 2);
68
+ this.foreground = this.isForeground();
69
+ var listen = function (target, type, listener) {
70
+ target.addEventListener(type, listener, { passive: true });
71
+ _this.removeListeners.push(function () { return target.removeEventListener(type, listener); });
72
+ };
73
+ try {
74
+ for (var _b = __values(['pointerdown', 'pointermove', 'keydown', 'scroll', 'touchstart', 'wheel']), _c = _b.next(); !_c.done; _c = _b.next()) {
75
+ var type = _c.value;
76
+ listen(scope.document, type, this.activity);
77
+ }
78
+ }
79
+ catch (e_1_1) { e_1 = { error: e_1_1 }; }
80
+ finally {
81
+ try {
82
+ if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
83
+ }
84
+ finally { if (e_1) throw e_1.error; }
85
+ }
86
+ listen(scope, 'focus', this.resume);
87
+ listen(scope, 'blur', this.pause);
88
+ listen(scope.document, 'visibilitychange', function () { return (_this.isForeground() ? _this.resume() : _this.pause()); });
89
+ // Leaving the document always ends this view, including entry into BFCache.
90
+ listen(scope, 'pagehide', function () { return _this.finish('pagehide'); });
91
+ listen(scope, 'pageshow', function () {
92
+ // A restored page starts a fresh view through the existing activity path.
93
+ if (_this.isForeground())
94
+ _this.resume();
95
+ });
96
+ }
97
+ PageEngagement.prototype.isForeground = function () {
98
+ return this.scope.document.visibilityState === 'visible' && this.scope.document.hasFocus();
99
+ };
100
+ PageEngagement.prototype.start = function (event) {
101
+ var _this = this;
102
+ var _a;
103
+ this.finish('navigation');
104
+ if (!this.enabled)
105
+ return false;
106
+ var now = Date.now();
107
+ this.foreground = this.isForeground();
108
+ var pageState = {
109
+ event: __assign(__assign({}, event), { insert_id: event.insert_id || UUID(), time: (_a = event.time) !== null && _a !== void 0 ? _a : now,
110
+ // Share the SDK inactivity duration with the service fallback. The SDK counts
111
+ // from last activity; the service counts from the last accepted heartbeat.
112
+ delay: { id: UUID(), timeout: this.timeout } }),
113
+ heartbeat: new Heartbeat(this.client, this.pulse, this.timeout, this.config.loggerProvider, {
114
+ // This owner settles elapsed time and finalizes before sending.
115
+ // Avoid a second set of lifecycle sends.
116
+ sendOnPageLifecycle: false,
117
+ beforeHeartbeat: function () {
118
+ // A heartbeat scheduled by the previous page must not update the new page state.
119
+ if (_this.pageState === pageState) {
120
+ if (Date.now() >= pageState.lastActivity + _this.timeout) {
121
+ _this.retire(pageState, 'inactivity');
122
+ }
123
+ else {
124
+ void pageState.heartbeat.update(_this.snapshot(pageState, pageState.nextSnapshotReason));
125
+ pageState.nextSnapshotReason = 'heartbeat';
126
+ }
127
+ }
128
+ },
129
+ }),
130
+ started: now,
131
+ updated: now,
132
+ lastActivity: now,
133
+ engaged: 0,
134
+ version: 0,
135
+ nextSnapshotReason: 'initial',
136
+ };
137
+ // Arrival after server expiry must not overwrite more recent identify updates.
138
+ delete pageState.event.user_properties;
139
+ var isEnqueued = pageState.heartbeat.enqueue(this.snapshot(pageState, 'initial'));
140
+ if (!isEnqueued) {
141
+ // Do not turn subsequent activity on this page into repeated fallback views.
142
+ this.skippedPage = true;
143
+ this.config.loggerProvider.warn('Page engagement: snapshot exceeds the Heartbeat size limit. Sending the original page view without engaged-time tracking.');
144
+ return false;
145
+ }
146
+ this.pageState = pageState;
147
+ this.scheduleInactivity();
148
+ void pageState.heartbeat.resetHeartbeat();
149
+ return true;
150
+ };
151
+ PageEngagement.prototype.settle = function (pageState) {
152
+ // Cap a late callback at the inactivity deadline; heartbeats never extend it.
153
+ var now = Math.max(pageState.updated, Math.min(Date.now(), pageState.lastActivity + this.timeout));
154
+ if (this.foreground) {
155
+ pageState.engaged += Math.max(0, Math.min(now, pageState.lastActivity + this.activityWindow) - pageState.updated);
156
+ }
157
+ pageState.updated = now;
158
+ };
159
+ PageEngagement.prototype.snapshot = function (pageState, reason) {
160
+ this.settle(pageState);
161
+ var version = ++pageState.version;
162
+ return __assign(__assign({}, pageState.event), { extra: __assign(__assign({}, pageState.event.extra), { pageEngagementSnapshot: true }), event_properties: __assign(__assign({}, pageState.event.event_properties), { '[Amplitude] Engaged Time': pageState.engaged, '[Amplitude] Total Time': pageState.updated - pageState.started,
163
+ // Internal diagnostics; version counts constructed snapshots, not requests.
164
+ '[Amplitude] Snapshot Version': version, '[Amplitude] Engagement Snapshot Reason': reason }) });
165
+ };
166
+ PageEngagement.prototype.scheduleInactivity = function () {
167
+ var _this = this;
168
+ clearTimeout(this.inactivityTimer);
169
+ this.inactivityTimer = setTimeout(function () { return _this.finish('inactivity'); }, this.timeout);
170
+ };
171
+ PageEngagement.prototype.sendBackground = function (pageState) {
172
+ var _this = this;
173
+ var remaining = pageState.lastBackgroundSent === undefined
174
+ ? 0
175
+ : pageState.lastBackgroundSent + BACKGROUND_SEND_INTERVAL - Date.now();
176
+ if (remaining > 0) {
177
+ // blur and hidden can describe the same transition. Keep a single trailing
178
+ // send at the original deadline, using the latest state when it fires.
179
+ if (pageState.backgroundTimer === undefined) {
180
+ pageState.backgroundTimer = setTimeout(function () {
181
+ pageState.backgroundTimer = undefined;
182
+ _this.sendBackground(pageState);
183
+ }, remaining);
184
+ }
185
+ return;
186
+ }
187
+ clearTimeout(pageState.backgroundTimer);
188
+ pageState.backgroundTimer = undefined;
189
+ pageState.lastBackgroundSent = Date.now();
190
+ pageState.nextSnapshotReason = 'background';
191
+ void pageState.heartbeat.heartbeat();
192
+ this.client.flush();
193
+ };
194
+ PageEngagement.prototype.retire = function (pageState, reason) {
195
+ clearTimeout(pageState.backgroundTimer);
196
+ clearTimeout(this.inactivityTimer);
197
+ var event = this.snapshot(pageState, reason);
198
+ event.delay = __assign(__assign({}, event.delay), { timeout: undefined });
199
+ void pageState.heartbeat.update(event);
200
+ pageState.heartbeat.pause();
201
+ this.pageState = undefined;
202
+ };
203
+ PageEngagement.prototype.finish = function (reason) {
204
+ this.skippedPage = false;
205
+ var pageState = this.pageState;
206
+ if (!pageState)
207
+ return;
208
+ this.retire(pageState, reason);
209
+ // Enqueue the final copy before clearing this page's heartbeat. Destination
210
+ // coalesces pending snapshots and preserves in-flight ordering by delay ID.
211
+ void pageState.heartbeat.heartbeat();
212
+ // Request delivery before waiting for ingestion, especially during page exit.
213
+ this.client.flush();
214
+ pageState.heartbeat.stop();
215
+ };
216
+ PageEngagement.prototype.setOptOut = function (optOut) {
217
+ var _a, _b;
218
+ this.enabled = !optOut;
219
+ if (optOut) {
220
+ this.skippedPage = false;
221
+ clearTimeout(this.inactivityTimer);
222
+ clearTimeout((_a = this.pageState) === null || _a === void 0 ? void 0 : _a.backgroundTimer);
223
+ (_b = this.pageState) === null || _b === void 0 ? void 0 : _b.heartbeat.stop();
224
+ this.pageState = undefined;
225
+ }
226
+ };
227
+ PageEngagement.prototype.teardown = function () {
228
+ this.finish('teardown');
229
+ this.enabled = false;
230
+ this.removeListeners.forEach(function (remove) { return remove(); });
231
+ };
232
+ return PageEngagement;
233
+ }());
234
+ export { PageEngagement };
235
+ //# sourceMappingURL=page-engagement.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"page-engagement.js","sourceRoot":"","sources":["../../src/page-engagement.ts"],"names":[],"mappings":";AAAA,OAAO,EAIL,SAAS,EAIT,IAAI,GACL,MAAM,2BAA2B,CAAC;AAEnC,MAAM,CAAC,IAAM,uBAAuB,GAAG,IAAK,CAAC;AAC7C,MAAM,CAAC,IAAM,4BAA4B,GAAG,KAAM,CAAC;AACnD,MAAM,CAAC,IAAM,0BAA0B,GAAG,MAAO,CAAC;AAClD,IAAM,wBAAwB,GAAG,IAAK,CAAC;AAevC,oFAAoF;AACpF,IAAM,sBAAsB,GAAG,UAAa,CAAC;AAC7C,4EAA4E;AAC5E,IAAM,6BAA6B,GAAG,QAAU,CAAC;AAEjD,SAAS,qBAAqB,CAC5B,KAAyB,EACzB,YAAoB,EACpB,MAAe,EACf,OAAgC;IAAhC,wBAAA,EAAA,gCAAgC;IAEhC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,YAAY,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,OAAO,EAAE;QAC5D,MAAM,CAAC,IAAI,CACT,oCAA6B,KAAK,2CAAiC,YAAY,qEAA2D,OAAO,SAAM,CACxJ,CAAC;QACF,OAAO,YAAY,CAAC;KACrB;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,sFAAsF;AACtF;IAWE,wBACU,MAAqB,EACrB,KAAqD,EAC7D,OAA2B,EACnB,MAAqB,EACrB,WAAuB;;QALjC,iBAuCC;QAtCS,WAAM,GAAN,MAAM,CAAe;QACrB,UAAK,GAAL,KAAK,CAAgD;QAErD,WAAM,GAAN,MAAM,CAAe;QACrB,gBAAW,GAAX,WAAW,CAAY;QAZzB,YAAO,GAAG,IAAI,CAAC;QACf,gBAAW,GAAG,KAAK,CAAC;QAIX,oBAAe,GAAmB,EAAE,CAAC;QAoI9C,aAAQ,GAAG;YACjB,IACE,CAAC,KAAI,CAAC,OAAO;gBACb,KAAI,CAAC,WAAW;gBAChB,CAAC,KAAI,CAAC,UAAU;gBACf,KAAI,CAAC,KAAK,CAAC,QAAkD,CAAC,YAAY;gBAE3E,OAAO;YACT,IAAI,KAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,KAAI,CAAC,SAAS,CAAC,YAAY,GAAG,KAAI,CAAC,OAAO;gBAAE,KAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAC1G,IAAI,CAAC,KAAI,CAAC,SAAS,EAAE;gBACnB,KAAI,CAAC,WAAW,EAAE,CAAC;gBACnB,OAAO;aACR;YACD,KAAI,CAAC,MAAM,CAAC,KAAI,CAAC,SAAS,CAAC,CAAC;YAC5B,KAAI,CAAC,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACzC,KAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5B,CAAC,CAAC;QAEM,WAAM,GAAG;YACf,IAAI,KAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,KAAK,SAAS;gBAAE,OAAO;YAC9D,IAAI,KAAI,CAAC,SAAS;gBAAE,KAAI,CAAC,MAAM,CAAC,KAAI,CAAC,SAAS,CAAC,CAAC;YAChD,KAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,KAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,CAAC,CAAC;QAEM,UAAK,GAAG;YACd,IAAI,KAAI,CAAC,SAAS;gBAAE,KAAI,CAAC,MAAM,CAAC,KAAI,CAAC,SAAS,CAAC,CAAC;YAChD,KAAI,CAAC,UAAU,GAAG,KAAK,CAAC;YACxB,IAAI,KAAI,CAAC,SAAS,EAAE;gBAClB,KAAI,CAAC,cAAc,CAAC,KAAI,CAAC,SAAS,CAAC,CAAC;aACrC;QACH,CAAC,CAAC;QA1JA,IAAI,CAAC,OAAO,GAAG,qBAAqB,CAClC,OAAO,CAAC,uBAAuB,EAC/B,0BAA0B,EAC1B,MAAM,CAAC,cAAc,EACrB,6BAA6B,CAC9B,CAAC;QACF,IAAI,CAAC,cAAc,GAAG,qBAAqB,CACzC,OAAO,CAAC,oBAAoB,EAC5B,uBAAuB,EACvB,MAAM,CAAC,cAAc,CACtB,CAAC;QACF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CACnB,qBAAqB,CAAC,OAAO,CAAC,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,CAAC,cAAc,CAAC,EAC3G,IAAI,CAAC,OAAO,GAAG,CAAC,CACjB,CAAC;QACF,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,IAAM,MAAM,GAAG,UAAC,MAAmB,EAAE,IAAY,EAAE,QAAuB;YACxE,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3D,KAAI,CAAC,eAAe,CAAC,IAAI,CAAC,cAAM,OAAA,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,EAA1C,CAA0C,CAAC,CAAC;QAC9E,CAAC,CAAC;;YACF,KAAmB,IAAA,KAAA,SAAA,CAAC,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,CAAA,gBAAA,4BAAE;gBAA1F,IAAM,IAAI,WAAA;gBACb,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;aAC7C;;;;;;;;;QACD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,kBAAkB,EAAE,cAAM,OAAA,CAAC,KAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,KAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,KAAI,CAAC,KAAK,EAAE,CAAC,EAApD,CAAoD,CAAC,CAAC;QACvG,4EAA4E;QAC5E,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE,cAAM,OAAA,KAAI,CAAC,MAAM,CAAC,UAAU,CAAC,EAAvB,CAAuB,CAAC,CAAC;QACzD,MAAM,CAAC,KAAK,EAAE,UAAU,EAAE;YACxB,0EAA0E;YAC1E,IAAI,KAAI,CAAC,YAAY,EAAE;gBAAE,KAAI,CAAC,MAAM,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,qCAAY,GAApB;QACE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAC7F,CAAC;IAED,8BAAK,GAAL,UAAM,KAAY;QAAlB,iBAoDC;;QAnDC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAChC,IAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,IAAM,SAAS,GAAc;YAC3B,KAAK,wBACA,KAAK,KACR,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,EAAE,EACpC,IAAI,EAAE,MAAA,KAAK,CAAC,IAAI,mCAAI,GAAG;gBACvB,8EAA8E;gBAC9E,2EAA2E;gBAC3E,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,GAC7C;YACD,SAAS,EAAE,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE;gBAC1F,gEAAgE;gBAChE,yCAAyC;gBACzC,mBAAmB,EAAE,KAAK;gBAC1B,eAAe,EAAE;oBACf,iFAAiF;oBACjF,IAAI,KAAI,CAAC,SAAS,KAAK,SAAS,EAAE;wBAChC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,SAAS,CAAC,YAAY,GAAG,KAAI,CAAC,OAAO,EAAE;4BACvD,KAAI,CAAC,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;yBACtC;6BAAM;4BACL,KAAK,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,KAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,kBAAkB,CAAC,CAAC,CAAC;4BACxF,SAAS,CAAC,kBAAkB,GAAG,WAAW,CAAC;yBAC5C;qBACF;gBACH,CAAC;aACF,CAAC;YACF,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,GAAG;YACZ,YAAY,EAAE,GAAG;YACjB,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;YACV,kBAAkB,EAAE,SAAS;SAC9B,CAAC;QACF,+EAA+E;QAC/E,OAAO,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC;QACvC,IAAM,UAAU,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;QACpF,IAAI,CAAC,UAAU,EAAE;YACf,6EAA6E;YAC7E,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAC7B,2HAA2H,CAC5H,CAAC;YACF,OAAO,KAAK,CAAC;SACd;QACD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC1B,KAAK,SAAS,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,+BAAM,GAAd,UAAe,SAAoB;QACjC,8EAA8E;QAC9E,IAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QACrG,IAAI,IAAI,CAAC,UAAU,EAAE;YACnB,SAAS,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;SACnH;QACD,SAAS,CAAC,OAAO,GAAG,GAAG,CAAC;IAC1B,CAAC;IAEO,iCAAQ,GAAhB,UAAiB,SAAoB,EAAE,MAAc;QACnD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACvB,IAAM,OAAO,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC;QACpC,6BACK,SAAS,CAAC,KAAK,KAClB,KAAK,wBAAO,SAAS,CAAC,KAAK,CAAC,KAAK,KAAE,sBAAsB,EAAE,IAAI,KAC/D,gBAAgB,wBACX,SAAS,CAAC,KAAK,CAAC,gBAAgB,KACnC,0BAA0B,EAAE,SAAS,CAAC,OAAO,EAC7C,wBAAwB,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO;gBAC/D,4EAA4E;gBAC5E,8BAA8B,EAAE,OAAO,EACvC,wCAAwC,EAAE,MAAM,OAElD;IACJ,CAAC;IAEO,2CAAkB,GAA1B;QAAA,iBAGC;QAFC,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACnC,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC,cAAM,OAAA,KAAI,CAAC,MAAM,CAAC,YAAY,CAAC,EAAzB,CAAyB,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACnF,CAAC;IAmCO,uCAAc,GAAtB,UAAuB,SAAoB;QAA3C,iBAsBC;QArBC,IAAM,SAAS,GACb,SAAS,CAAC,kBAAkB,KAAK,SAAS;YACxC,CAAC,CAAC,CAAC;YACH,CAAC,CAAC,SAAS,CAAC,kBAAkB,GAAG,wBAAwB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3E,IAAI,SAAS,GAAG,CAAC,EAAE;YACjB,2EAA2E;YAC3E,uEAAuE;YACvE,IAAI,SAAS,CAAC,eAAe,KAAK,SAAS,EAAE;gBAC3C,SAAS,CAAC,eAAe,GAAG,UAAU,CAAC;oBACrC,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC;oBACtC,KAAI,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;gBACjC,CAAC,EAAE,SAAS,CAAC,CAAC;aACf;YACD,OAAO;SACR;QACD,YAAY,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACxC,SAAS,CAAC,eAAe,GAAG,SAAS,CAAC;QACtC,SAAS,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1C,SAAS,CAAC,kBAAkB,GAAG,YAAY,CAAC;QAC5C,KAAK,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAEO,+BAAM,GAAd,UAAe,SAAoB,EAAE,MAAc;QACjD,YAAY,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACxC,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACnC,IAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC/C,KAAK,CAAC,KAAK,yBAAQ,KAAK,CAAC,KAAM,KAAE,OAAO,EAAE,SAAS,GAAE,CAAC;QACtD,KAAK,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,+BAAM,GAAN,UAAO,MAAc;QACnB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;QACzB,IAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QACjC,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC/B,4EAA4E;QAC5E,4EAA4E;QAC5E,KAAK,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;QACrC,8EAA8E;QAC9E,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED,kCAAS,GAAT,UAAU,MAAe;;QACvB,IAAI,CAAC,OAAO,GAAG,CAAC,MAAM,CAAC;QACvB,IAAI,MAAM,EAAE;YACV,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;YACzB,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACnC,YAAY,CAAC,MAAA,IAAI,CAAC,SAAS,0CAAE,eAAe,CAAC,CAAC;YAC9C,MAAA,IAAI,CAAC,SAAS,0CAAE,SAAS,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;SAC5B;IACH,CAAC;IAED,iCAAQ,GAAR;QACE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,UAAC,MAAM,IAAK,OAAA,MAAM,EAAE,EAAR,CAAQ,CAAC,CAAC;IACrD,CAAC;IACH,qBAAC;AAAD,CAAC,AA7OD,IA6OC","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 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: duration ${value} ms is invalid; using default ${defaultValue} ms. Expected a finite value greater than 0 and at most ${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. */\nexport class PageEngagement {\n private pageState?: PageState;\n private inactivityTimer?: ReturnType<typeof setTimeout>;\n private foreground: boolean;\n private enabled = true;\n private skippedPage = false;\n private readonly activityWindow: number;\n private readonly pulse: number;\n private readonly timeout: number;\n private readonly removeListeners: (() => void)[] = [];\n\n constructor(\n private client: BrowserClient,\n private scope: NonNullable<ReturnType<typeof getGlobalScope>>,\n options: EngagedTimeOptions,\n private config: BrowserConfig,\n private newPageView: () => void,\n ) {\n this.timeout = resolveDurationMillis(\n options.inactivityTimeoutMillis,\n DEFAULT_INACTIVITY_TIMEOUT,\n config.loggerProvider,\n MAX_INACTIVITY_TIMEOUT_MILLIS,\n );\n this.activityWindow = resolveDurationMillis(\n options.activityWindowMillis,\n DEFAULT_ACTIVITY_WINDOW,\n config.loggerProvider,\n );\n this.pulse = Math.min(\n resolveDurationMillis(options.heartbeatIntervalMillis, DEFAULT_ENGAGEMENT_HEARTBEAT, config.loggerProvider),\n this.timeout / 2,\n );\n this.foreground = this.isForeground();\n const listen = (target: EventTarget, type: string, listener: EventListener) => {\n target.addEventListener(type, listener, { passive: true });\n this.removeListeners.push(() => target.removeEventListener(type, listener));\n };\n for (const type of ['pointerdown', 'pointermove', 'keydown', 'scroll', 'touchstart', 'wheel']) {\n listen(scope.document, type, this.activity);\n }\n listen(scope, 'focus', this.resume);\n listen(scope, 'blur', this.pause);\n listen(scope.document, 'visibilitychange', () => (this.isForeground() ? this.resume() : this.pause()));\n // Leaving the document always ends this view, including entry into BFCache.\n listen(scope, 'pagehide', () => this.finish('pagehide'));\n listen(scope, 'pageshow', () => {\n // A restored page starts a fresh view through the existing activity path.\n if (this.isForeground()) this.resume();\n });\n }\n\n private isForeground() {\n return this.scope.document.visibilityState === 'visible' && this.scope.document.hasFocus();\n }\n\n start(event: Event): boolean {\n this.finish('navigation');\n if (!this.enabled) return false;\n const now = Date.now();\n this.foreground = this.isForeground();\n const pageState: PageState = {\n event: {\n ...event,\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: this.timeout },\n },\n heartbeat: new Heartbeat(this.client, this.pulse, this.timeout, this.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 (this.pageState === pageState) {\n if (Date.now() >= pageState.lastActivity + this.timeout) {\n this.retire(pageState, 'inactivity');\n } else {\n void pageState.heartbeat.update(this.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: 'initial',\n };\n // Arrival after server expiry must not overwrite more recent identify updates.\n delete pageState.event.user_properties;\n const isEnqueued = pageState.heartbeat.enqueue(this.snapshot(pageState, 'initial'));\n if (!isEnqueued) {\n // Do not turn subsequent activity on this page into repeated fallback views.\n this.skippedPage = true;\n this.config.loggerProvider.warn(\n 'Page engagement: snapshot exceeds the Heartbeat size limit. Sending the original page view without engaged-time tracking.',\n );\n return false;\n }\n this.pageState = pageState;\n this.scheduleInactivity();\n void pageState.heartbeat.resetHeartbeat();\n return true;\n }\n\n private 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 + this.timeout));\n if (this.foreground) {\n pageState.engaged += Math.max(0, Math.min(now, pageState.lastActivity + this.activityWindow) - pageState.updated);\n }\n pageState.updated = now;\n }\n\n private snapshot(pageState: PageState, reason: string): Event {\n this.settle(pageState);\n const version = ++pageState.version;\n return {\n ...pageState.event,\n extra: { ...pageState.event.extra, pageEngagementSnapshot: 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 private scheduleInactivity() {\n clearTimeout(this.inactivityTimer);\n this.inactivityTimer = setTimeout(() => this.finish('inactivity'), this.timeout);\n }\n\n private activity = () => {\n if (\n !this.enabled ||\n this.skippedPage ||\n !this.foreground ||\n (this.scope.document as Document & { prerendering?: boolean }).prerendering\n )\n return;\n if (this.pageState && Date.now() >= this.pageState.lastActivity + this.timeout) this.finish('inactivity');\n if (!this.pageState) {\n this.newPageView();\n return;\n }\n this.settle(this.pageState);\n this.pageState.lastActivity = Date.now();\n this.scheduleInactivity();\n };\n\n private resume = () => {\n if (this.scope.document.visibilityState !== 'visible') return;\n if (this.pageState) this.settle(this.pageState);\n this.foreground = true;\n this.activity();\n };\n\n private pause = () => {\n if (this.pageState) this.settle(this.pageState);\n this.foreground = false;\n if (this.pageState) {\n this.sendBackground(this.pageState);\n }\n };\n\n private 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 this.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 this.client.flush();\n }\n\n private retire(pageState: PageState, reason: string) {\n clearTimeout(pageState.backgroundTimer);\n clearTimeout(this.inactivityTimer);\n const event = this.snapshot(pageState, reason);\n event.delay = { ...event.delay!, timeout: undefined };\n void pageState.heartbeat.update(event);\n pageState.heartbeat.pause();\n this.pageState = undefined;\n }\n\n finish(reason: string) {\n this.skippedPage = false;\n const pageState = this.pageState;\n if (!pageState) return;\n this.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 void pageState.heartbeat.heartbeat();\n // Request delivery before waiting for ingestion, especially during page exit.\n this.client.flush();\n pageState.heartbeat.stop();\n }\n\n setOptOut(optOut: boolean) {\n this.enabled = !optOut;\n if (optOut) {\n this.skippedPage = false;\n clearTimeout(this.inactivityTimer);\n clearTimeout(this.pageState?.backgroundTimer);\n this.pageState?.heartbeat.stop();\n this.pageState = undefined;\n }\n }\n\n teardown() {\n this.finish('teardown');\n this.enabled = false;\n this.removeListeners.forEach((remove) => remove());\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"page-view-tracking.d.ts","sourceRoot":"","sources":["../../src/page-view-tracking.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,4BAA4B,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAErF,eAAO,MAAM,oBAAoB,4BAA4B,CAAC;AAC9D,OAAO,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAM1E,eAAO,MAAM,sBAAsB,EAAE,4BA6KpC,CAAC;AAqCF,eAAO,MAAM,0BAA0B,mBACrB,OAAO,CAAC,qBAAqB,CAAC,aACnC,MAAM,aACN,MAAM,KAChB,OAaF,CAAC"}
1
+ {"version":3,"file":"page-view-tracking.d.ts","sourceRoot":"","sources":["../../src/page-view-tracking.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,4BAA4B,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAGrF,eAAO,MAAM,oBAAoB,4BAA4B,CAAC;AAC9D,OAAO,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAM1E,eAAO,MAAM,sBAAsB,EAAE,4BA2RpC,CAAC;AAqCF,eAAO,MAAM,0BAA0B,mBACrB,OAAO,CAAC,qBAAqB,CAAC,aACnC,MAAM,aACN,MAAM,KAChB,OAaF,CAAC"}