@esri/telemetry-amazon 6.0.0-beta.1 → 6.0.0-beta.10

package/dist/esm/index.test.js

@@ -1,16 +1,27 @@
 import { Amazon } from '.';
-import { createPinpointPlugin } from './plugins/pinpoint';
+import Analytics from 'analytics';
+import awsPinpointPlugin from '@analytics/aws-pinpoint';
 import { createEsriPlugin } from './plugins/esri';
-jest.mock('./plugins/pinpoint', () => ({
-    createPinpointPlugin: jest.fn(() => ({ track: jest.fn(() => true) })),
+jest.mock('analytics', () => ({
+    __esModule: true,
+    default: jest.fn(() => ({ track: jest.fn(() => true) })),
+}));
+jest.mock('@analytics/aws-pinpoint', () => ({
+    __esModule: true,
+    default: jest.fn(() => ({
+        name: 'aws-pinpoint',
+    })),
 }));
 jest.mock('./plugins/esri', () => ({
     createEsriPlugin: jest.fn(() => ({ track: jest.fn(() => true) })),
 }));
-const createPinpointPluginMock = createPinpointPlugin;
+const AnalyticsMock = Analytics;
+const awsPinpointPluginMock = awsPinpointPlugin;
 const createEsriPluginMock = createEsriPlugin;
+const PINPOINT_RETIREMENT_CUTOFF_UTC_ISO = '2026-10-31T00:00:00.000Z';
 describe('Amazon', () => {
     afterEach(() => {
+        jest.useRealTimers();
         jest.clearAllMocks();
     });
     test('Amazon constructor and permissions', () => {
@@ -29,9 +40,12 @@ describe('Amazon', () => {
             mode: 'pinpoint',
         }));
     });
-    test('pinpoint mode initializes pinpoint plugin with mapped options', () => {
-        const pinpointPlugin = { track: jest.fn(() => true) };
-        createPinpointPluginMock.mockReturnValue(pinpointPlugin);
+    test('pinpoint mode initializes upstream analytics pinpoint plugin', () => {
+        jest
+            .useFakeTimers('modern')
+            .setSystemTime(new Date('2026-10-30T23:59:59.000Z').getTime());
+        const analyticsInstance = { track: jest.fn(() => true) };
+        AnalyticsMock.mockReturnValue(analyticsInstance);
         new Amazon({
             userPoolID: 'pool-id',
             app: {
@@ -42,16 +56,44 @@ describe('Amazon', () => {
             mode: 'pinpoint',
             fips: true,
         });
-        expect(createPinpointPluginMock).toHaveBeenCalledWith({
+        expect(awsPinpointPluginMock).toHaveBeenCalledWith({
+            fips: true,
+            pinpointAppId: '1234',
+            getCredentials: expect.any(Function),
+        });
+        expect(AnalyticsMock).toHaveBeenCalledWith({
+            app: 'test',
+            version: '1.0.0',
+            plugins: [expect.any(Object)],
+        });
+        expect(createEsriPluginMock).not.toHaveBeenCalled();
+    });
+    test('pinpoint mode falls back to esri mode on and after retirement cutoff', () => {
+        jest
+            .useFakeTimers('modern')
+            .setSystemTime(new Date(PINPOINT_RETIREMENT_CUTOFF_UTC_ISO));
+        new Amazon({
+            userPoolID: 'pool-id',
+            app: {
+                name: 'test',
+                id: '1234',
+                version: '1.0.0',
+            },
+            mode: 'pinpoint',
+            fips: true,
+        });
+        expect(awsPinpointPluginMock).not.toHaveBeenCalled();
+        expect(AnalyticsMock).not.toHaveBeenCalled();
+        expect(createEsriPluginMock).toHaveBeenCalledWith({
+            trackerName: 'amazon',
             appName: 'test',
             appVersion: '1.0.0',
             appId: '1234',
             userPoolID: 'pool-id',
             fips: true,
         });
-        expect(createEsriPluginMock).not.toHaveBeenCalled();
     });
-    test('esri mode initializes esri plugin with url/headers', () => {
+    test('esri mode initializes esri plugin with internal endpoint config', () => {
         const esriPlugin = { track: jest.fn(() => true) };
         createEsriPluginMock.mockReturnValue(esriPlugin);
         new Amazon({
@@ -61,19 +103,51 @@ describe('Amazon', () => {
                 id: '1234',
             },
             mode: 'esri',
-            endpoint: {
-                url: 'https://example.com/events',
-                headers: { 'x-test': '1' },
+        });
+        expect(createEsriPluginMock).toHaveBeenCalledWith({
+            trackerName: 'amazon',
+            appName: 'test',
+            appVersion: undefined,
+            appId: '1234',
+            userPoolID: 'pool-id',
+            fips: undefined,
+        });
+        expect(AnalyticsMock).not.toHaveBeenCalled();
+    });
+    test('esri mode does not throw when userPoolID is missing at runtime', () => {
+        new Amazon({
+            mode: 'esri',
+            app: {
+                name: 'test',
+                id: '1234',
             },
         });
         expect(createEsriPluginMock).toHaveBeenCalledWith({
-            url: 'https://example.com/events',
-            headers: { 'x-test': '1' },
             trackerName: 'amazon',
             appName: 'test',
             appVersion: undefined,
+            appId: '1234',
+            userPoolID: undefined,
+            fips: undefined,
+        });
+        expect(AnalyticsMock).not.toHaveBeenCalled();
+    });
+    test('logEvent forwards immediate track option to analytics.track', () => {
+        const track = jest.fn(() => true);
+        createEsriPluginMock.mockReturnValue({ track });
+        const telemetry = new Amazon({
+            userPoolID: 'pool-id',
+            app: {
+                name: 'test',
+                id: '1234',
+            },
+            mode: 'esri',
         });
-        expect(createPinpointPluginMock).not.toHaveBeenCalled();
+        const result = telemetry.logEvent({ eventType: 'cta_click', category: 'nav' }, { immediate: true });
+        const trackMock = track;
+        expect(result).toBe(true);
+        expect(trackMock).toHaveBeenCalledTimes(1);
+        expect(trackMock.mock.calls[0][2]).toEqual({ immediate: true });
     });
 });
 //# sourceMappingURL=index.test.js.map

package/dist/esm/index.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/index.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../src/index.test.ts"],"names":[],"mappings":"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"}

package/dist/esm/plugins/esri.js

@@ -1,14 +1,19 @@
-import { debugLog, warnLog, getEndpointId } from './shared';
-function getString(value, fallback = '') {
-    if (value === undefined || value === null) {
-        return fallback;
-    }
-    return String(value);
-}
+import { AwsClient } from 'aws4fetch';
+import { getCredentials } from '../auth';
+import { debugLog, warnLog, getEndpointId, getBrowserClientInfo, } from './utils/shared';
+const ESRI_SIGNING_SERVICE = 'execute-api';
+const ESRI_SIGNING_REGION = 'us-east-1';
+const ESRI_ENDPOINT_URL = (appId) => `https://tedev.arcgis.com/v1/apps/${appId}/events`;
+const SESSION_START_EVENT = '_session.start';
+const SESSION_STOP_EVENT = '_session.stop';
+const DEFAULT_IDLE_TIMEOUT_MS = 30 * 60 * 1000;
+const DEFAULT_DEBOUNCE_MS = 5000;
+/** Converts a string to a number, guarded against invalid values */
 function getNumber(value, fallback = 0) {
     const numeric = Number(value);
     return Number.isFinite(numeric) ? numeric : fallback;
 }
+/** Splits an EsriBatchEventPayload into attributes and metrics */
 function splitEventData(payload) {
     const attributes = {};
     const metrics = {};
@@ -45,93 +50,369 @@ function splitEventData(payload) {
         metrics,
     };
 }
-function buildBatchEventPayload({ eventName, payload, trackerName, appName, appVersion, }) {
+/** Constructs an event payload in the shape expected by the endpoint.  */
+function buildBatchEventPayload({ queuedEvents, trackerName, appName, appVersion, }) {
+    var _a, _b, _c, _d, _e, _f;
+    const endpointEvent = queuedEvents[queuedEvents.length - 1] ||
+        {
+            payload: {},
+            browserInfo: {},
+        };
+    const payload = endpointEvent.payload || {};
+    const browserInfo = endpointEvent.browserInfo || {};
     const endpointId = getEndpointId();
-    const sessionId = `${Date.now()}-${Math.random().toString(16).slice(2)}`;
-    const timestamp = new Date().toISOString();
-    const { attributes, metrics } = splitEventData(payload);
+    const location = {};
+    if (payload === null || payload === void 0 ? void 0 : payload.city) {
+        location.City = payload.city;
+    }
+    if (payload === null || payload === void 0 ? void 0 : payload.country) {
+        location.Country = payload.country;
+    }
+    if ((payload === null || payload === void 0 ? void 0 : payload.lat) !== undefined && (payload === null || payload === void 0 ? void 0 : payload.lat) !== null) {
+        location.Lat = getNumber(payload.lat);
+    }
+    if ((payload === null || payload === void 0 ? void 0 : payload.lon) !== undefined && (payload === null || payload === void 0 ? void 0 : payload.lon) !== null) {
+        location.Lon = getNumber(payload.lon);
+    }
     return {
         BatchEvent: {
             Endpoint: {
                 Id: endpointId,
-                Device: {
-                    Make: getString(payload === null || payload === void 0 ? void 0 : payload.deviceMake),
-                    Model: getString(payload === null || payload === void 0 ? void 0 : payload.deviceModel),
-                },
-                Location: {
-                    City: getString(payload === null || payload === void 0 ? void 0 : payload.city),
-                    Country: getString(payload === null || payload === void 0 ? void 0 : payload.country),
-                    Lat: getNumber(payload === null || payload === void 0 ? void 0 : payload.lat),
-                    Lon: getNumber(payload === null || payload === void 0 ? void 0 : payload.lon),
-                },
+                Device: Object.assign({ Locale: (browserInfo === null || browserInfo === void 0 ? void 0 : browserInfo.language) || '', Make: (payload === null || payload === void 0 ? void 0 : payload.deviceMake) || (browserInfo === null || browserInfo === void 0 ? void 0 : browserInfo.make) || '', Model: (payload === null || payload === void 0 ? void 0 : payload.deviceModel) || (browserInfo === null || browserInfo === void 0 ? void 0 : browserInfo.model) || '', ModelVersion: (browserInfo === null || browserInfo === void 0 ? void 0 : browserInfo.version) || '', Platform: ((_a = browserInfo === null || browserInfo === void 0 ? void 0 : browserInfo.os) === null || _a === void 0 ? void 0 : _a.name) || (browserInfo === null || browserInfo === void 0 ? void 0 : browserInfo.platform) || '' }, (((_b = browserInfo === null || browserInfo === void 0 ? void 0 : browserInfo.os) === null || _b === void 0 ? void 0 : _b.version)
+                    ? { PlatformVersion: browserInfo.os.version }
+                    : {})),
+                Location: location,
                 Application: {
-                    AppTitle: getString(payload === null || payload === void 0 ? void 0 : payload.appTitle, appName || trackerName),
-                    AppVersion: getString(payload === null || payload === void 0 ? void 0 : payload.appVersion, appVersion),
-                    ClientSdkVersion: getString(payload === null || payload === void 0 ? void 0 : payload.clientSdkVersion, trackerName),
+                    AppTitle: (_d = (_c = payload === null || payload === void 0 ? void 0 : payload.appTitle) !== null && _c !== void 0 ? _c : appName) !== null && _d !== void 0 ? _d : trackerName,
+                    AppVersion: (_e = payload === null || payload === void 0 ? void 0 : payload.appVersion) !== null && _e !== void 0 ? _e : appVersion,
+                    ClientSdkVersion: (_f = payload === null || payload === void 0 ? void 0 : payload.clientSdkVersion) !== null && _f !== void 0 ? _f : trackerName,
                 },
             },
-            Events: [
-                {
-                    EventType: eventName,
+            Events: queuedEvents.map((queuedEvent) => {
+                const timestamp = queuedEvent.timestamp;
+                const { attributes, metrics } = splitEventData(queuedEvent.payload);
+                const sessionContext = queuedEvent.session ||
+                    {
+                        id: `${queuedEvent.unixMs}-${Math.random().toString(16).slice(2)}`,
+                        startTimestamp: timestamp,
+                        startUnixMs: queuedEvent.unixMs,
+                    };
+                const isStopEvent = queuedEvent.eventName === SESSION_STOP_EVENT;
+                return {
+                    EventType: queuedEvent.eventName,
                     Timestamp: timestamp,
                     Session: {
-                        Id: sessionId,
-                        StartTimestamp: timestamp,
+                        Id: sessionContext.id,
+                        StartTimestamp: sessionContext.startTimestamp,
                         EndTimestamp: timestamp,
-                        Duration: 0,
+                        Duration: isStopEvent
+                            ? Math.max(0, queuedEvent.unixMs - sessionContext.startUnixMs)
+                            : 0,
                     },
                     Attributes: attributes,
                     Metrics: metrics,
-                },
-            ],
+                };
+            }),
         },
     };
 }
-export function createEsriPlugin({ url, headers = {}, trackerName, appName, appVersion, }) {
+export function createEsriPlugin({ trackerName, appName, appId, appVersion, userPoolID, fips, debounceMs = DEFAULT_DEBOUNCE_MS, }) {
+    const url = ESRI_ENDPOINT_URL(appId);
+    let isDisabled = false;
+    let hasWarned = false;
+    let hasSessionStarted = false;
+    let sessionStopSent = false;
+    let activeSession;
+    let idleTimerId;
+    let debounceTimerId;
+    let lifecycleListenersAttached = false;
+    const removeLifecycleListeners = [];
+    let pendingEvents = [];
+    const isBrowser = typeof window !== 'undefined' && typeof document !== 'undefined';
+    const warnOnce = (message, details) => {
+        if (hasWarned) {
+            return;
+        }
+        hasWarned = true;
+        warnLog(message, details);
+    };
     debugLog('createEsriPlugin initialized', {
         trackerName,
         hasUrl: Boolean(url),
-        headerCount: Object.keys(headers).length,
     });
-    return {
-        track: (eventName, payload) => {
-            if (!url || typeof fetch !== 'function') {
-                debugLog('Skipping endpoint track call', {
-                    eventName,
-                    reason: !url ? 'missing-url' : 'fetch-unavailable',
-                });
-                return false;
-            }
-            debugLog('Sending endpoint event', {
-                eventName,
-                trackerName,
-                url,
+    if (!url) {
+        isDisabled = true;
+        warnOnce('Esri telemetry disabled due to missing internal endpoint URL', {
+            trackerName,
+        });
+    }
+    if (!userPoolID) {
+        isDisabled = true;
+        warnOnce('Esri telemetry disabled due to missing userPoolID', {
+            trackerName,
+        });
+    }
+    if (typeof fetch !== 'function') {
+        isDisabled = true;
+        warnOnce('Esri telemetry disabled because fetch is unavailable', {
+            trackerName,
+        });
+    }
+    const clearIdleTimer = () => {
+        if (!idleTimerId) {
+            return;
+        }
+        clearTimeout(idleTimerId);
+        idleTimerId = undefined;
+    };
+    const clearDebounceTimer = () => {
+        if (!debounceTimerId) {
+            return;
+        }
+        clearTimeout(debounceTimerId);
+        debounceTimerId = undefined;
+    };
+    const clearPendingEvents = () => {
+        pendingEvents = [];
+    };
+    const enqueueEvent = (event) => {
+        pendingEvents.push(event);
+    };
+    const dequeuePendingEvents = () => {
+        if (pendingEvents.length === 0) {
+            return [];
+        }
+        const queuedEvents = pendingEvents;
+        pendingEvents = [];
+        return queuedEvents;
+    };
+    const sendQueuedEvents = (queuedEvents) => {
+        var _a;
+        if (queuedEvents.length === 0) {
+            return;
+        }
+        if (isDisabled || !url || !userPoolID) {
+            debugLog('Skipping esri track call', {
+                eventName: (_a = queuedEvents[queuedEvents.length - 1]) === null || _a === void 0 ? void 0 : _a.eventName,
+                reason: 'plugin-disabled',
             });
-            void fetch(url, {
-                method: 'POST',
-                headers: Object.assign({ 'Content-Type': 'application/json' }, headers),
-                body: JSON.stringify(buildBatchEventPayload({
-                    eventName,
-                    payload,
-                    trackerName,
-                    appName,
-                    appVersion,
-                })),
-            })
-                .then(() => {
+            return;
+        }
+        debugLog('Sending esri endpoint batch event', {
+            trackerName,
+            url,
+            eventCount: queuedEvents.length,
+        });
+        void (async () => {
+            var _a;
+            try {
+                const credentials = await getCredentials(userPoolID, { fips });
+                const accessKeyId = (credentials === null || credentials === void 0 ? void 0 : credentials.AccessKeyId) || (credentials === null || credentials === void 0 ? void 0 : credentials.accessKeyId);
+                const secretAccessKey = (credentials === null || credentials === void 0 ? void 0 : credentials.SecretKey) || (credentials === null || credentials === void 0 ? void 0 : credentials.secretAccessKey);
+                const sessionToken = (credentials === null || credentials === void 0 ? void 0 : credentials.SessionToken) || (credentials === null || credentials === void 0 ? void 0 : credentials.sessionToken);
+                if (!accessKeyId || !secretAccessKey) {
+                    throw new Error('Signed endpoint credentials are missing required key fields.');
+                }
+                const client = new AwsClient({
+                    accessKeyId,
+                    secretAccessKey,
+                    sessionToken,
+                    service: ESRI_SIGNING_SERVICE,
+                    region: ESRI_SIGNING_REGION,
+                });
+                await client.fetch(url, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify(buildBatchEventPayload({
+                        queuedEvents,
+                        trackerName,
+                        appName,
+                        appVersion,
+                    })),
+                });
                 debugLog('Endpoint event sent', {
-                    eventName,
                     trackerName,
+                    eventCount: queuedEvents.length,
                 });
-            })
-                .catch((error) => {
-                warnLog('Endpoint track failed', {
-                    eventName,
+            }
+            catch (error) {
+                isDisabled = true;
+                clearIdleTimer();
+                clearDebounceTimer();
+                clearPendingEvents();
+                removeAllLifecycleListeners();
+                warnOnce('Esri telemetry disabled after endpoint track failure', {
+                    eventName: (_a = queuedEvents[queuedEvents.length - 1]) === null || _a === void 0 ? void 0 : _a.eventName,
                     trackerName,
                     message: (error === null || error === void 0 ? void 0 : error.message) || String(error),
                 });
+            }
+        })();
+    };
+    const flushPendingEvents = (eventToAppend) => {
+        clearDebounceTimer();
+        const queuedEvents = dequeuePendingEvents();
+        if (eventToAppend) {
+            queuedEvents.push(eventToAppend);
+        }
+        sendQueuedEvents(queuedEvents);
+    };
+    const scheduleDebounceFlush = () => {
+        clearDebounceTimer();
+        debounceTimerId = setTimeout(() => {
+            flushPendingEvents();
+        }, debounceMs);
+    };
+    const removeAllLifecycleListeners = () => {
+        removeLifecycleListeners.splice(0).forEach((removeListener) => {
+            removeListener();
+        });
+        lifecycleListenersAttached = false;
+    };
+    const createSession = () => {
+        const now = Date.now();
+        return {
+            id: `${now}-${Math.random().toString(16).slice(2)}`,
+            startTimestamp: new Date(now).toISOString(),
+            startUnixMs: now,
+        };
+    };
+    const sendEvent = (eventName, payload, sessionOverride, options, forceImmediate = false) => {
+        if (isDisabled || !url || !userPoolID) {
+            debugLog('Skipping esri track call', {
+                eventName,
+                reason: 'plugin-disabled',
             });
-            return true;
+            return false;
+        }
+        debugLog('Queueing esri endpoint event', {
+            eventName,
+            trackerName,
+            immediate: Boolean((options === null || options === void 0 ? void 0 : options.immediate) || forceImmediate),
+        });
+        const queuedEvent = {
+            eventName,
+            payload: payload,
+            session: sessionOverride || activeSession,
+            browserInfo: getBrowserClientInfo(),
+            timestamp: new Date().toISOString(),
+            unixMs: Date.now(),
+        };
+        if ((options === null || options === void 0 ? void 0 : options.immediate) || forceImmediate) {
+            flushPendingEvents(queuedEvent);
+        }
+        else {
+            enqueueEvent(queuedEvent);
+            scheduleDebounceFlush();
+        }
+        return true;
+    };
+    const sendSessionLifecycleEvent = (eventName, reason, sessionOverride) => {
+        return sendEvent(eventName, {
+            reason,
+        }, sessionOverride, undefined, true);
+    };
+    const stopSession = (reason) => {
+        if (!hasSessionStarted || sessionStopSent) {
+            return false;
+        }
+        const sessionToStop = activeSession;
+        const didStop = sendSessionLifecycleEvent(SESSION_STOP_EVENT, reason, sessionToStop);
+        if (didStop) {
+            sessionStopSent = true;
+            hasSessionStarted = false;
+            clearIdleTimer();
+            activeSession = undefined;
+        }
+        return didStop;
+    };
+    const startSession = (reason) => {
+        if (hasSessionStarted) {
+            return false;
+        }
+        activeSession = activeSession || createSession();
+        const sessionToStart = activeSession;
+        const didStart = sendSessionLifecycleEvent(SESSION_START_EVENT, reason, sessionToStart);
+        if (didStart) {
+            hasSessionStarted = true;
+            sessionStopSent = false;
+        }
+        else {
+            activeSession = undefined;
+        }
+        return didStart;
+    };
+    const resetIdleTimer = () => {
+        if (!isBrowser || isDisabled || !hasSessionStarted) {
+            return;
+        }
+        clearIdleTimer();
+        idleTimerId = setTimeout(() => {
+            stopSession('idle');
+        }, DEFAULT_IDLE_TIMEOUT_MS);
+    };
+    const handleActivity = () => {
+        if (isDisabled) {
+            return;
+        }
+        if (!hasSessionStarted) {
+            startSession('wakeup');
+        }
+        resetIdleTimer();
+    };
+    const addLifecycleListener = (target, eventName, listener) => {
+        target.addEventListener(eventName, listener);
+        removeLifecycleListeners.push(() => {
+            target.removeEventListener(eventName, listener);
+        });
+    };
+    const attachLifecycleListeners = () => {
+        if (!isBrowser || lifecycleListenersAttached || isDisabled) {
+            return;
+        }
+        const activityEvents = ['pointerdown', 'keydown', 'scroll', 'focus'];
+        activityEvents.forEach((eventName) => {
+            addLifecycleListener(window, eventName, handleActivity);
+        });
+        addLifecycleListener(window, 'beforeunload', () => {
+            stopSession('beforeunload');
+        });
+        lifecycleListenersAttached = true;
+    };
+    return {
+        track: (eventName, payload, options) => {
+            void options;
+            attachLifecycleListeners();
+            const isSessionStopEvent = eventName === SESSION_STOP_EVENT;
+            if (!hasSessionStarted &&
+                eventName !== SESSION_START_EVENT &&
+                !isSessionStopEvent) {
+                startSession('init');
+            }
+            if (eventName === SESSION_START_EVENT) {
+                activeSession = activeSession || createSession();
+                hasSessionStarted = true;
+                sessionStopSent = false;
+            }
+            if (isSessionStopEvent) {
+                sessionStopSent = true;
+                hasSessionStarted = false;
+                clearIdleTimer();
+            }
+            if (hasSessionStarted && !activeSession && !isSessionStopEvent) {
+                activeSession = createSession();
+            }
+            if (hasSessionStarted && !isSessionStopEvent) {
+                resetIdleTimer();
+            }
+            const sessionForEvent = activeSession;
+            const didSend = sendEvent(eventName, payload, sessionForEvent, options, eventName === SESSION_START_EVENT || eventName === SESSION_STOP_EVENT);
+            if (isSessionStopEvent && didSend) {
+                activeSession = undefined;
+            }
+            return didSend;
         },
     };
 }