@esri/telemetry-amazon 6.0.0-beta.0 → 6.0.0-beta.2

package/dist/esm/plugins/esri.js

@@ -0,0 +1,185 @@
+import { AwsClient } from 'aws4fetch';
+import { getCredentials } from '../auth';
+import { debugLog, warnLog, getEndpointId } from './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`;
+/** 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;
+}
+function splitEventData(payload) {
+    const attributes = {};
+    const metrics = {};
+    const excludedKeys = new Set([
+        'name',
+        'appTitle',
+        'appVersion',
+        'clientSdkVersion',
+        'deviceMake',
+        'deviceModel',
+        'city',
+        'country',
+        'lat',
+        'lon',
+    ]);
+    Object.entries(payload || {}).forEach(([key, value]) => {
+        if (excludedKeys.has(key) || value === undefined || value === null) {
+            return;
+        }
+        if (typeof value === 'number' && Number.isFinite(value)) {
+            metrics[key] = value;
+            return;
+        }
+        if (typeof value === 'string' || typeof value === 'boolean') {
+            attributes[key] = String(value);
+            return;
+        }
+        if (Array.isArray(value) || typeof value === 'object') {
+            attributes[key] = JSON.stringify(value);
+        }
+    });
+    return {
+        attributes,
+        metrics,
+    };
+}
+function buildBatchEventPayload({ eventName, payload, trackerName, appName, appVersion, }) {
+    var _a, _b, _c, _d;
+    const endpointId = getEndpointId();
+    const sessionId = `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+    const timestamp = new Date().toISOString();
+    const { attributes, metrics } = splitEventData(payload);
+    return {
+        BatchEvent: {
+            Endpoint: {
+                Id: endpointId,
+                Device: {
+                    Make: (payload === null || payload === void 0 ? void 0 : payload.deviceMake) || '',
+                    Model: (payload === null || payload === void 0 ? void 0 : payload.deviceModel) || '',
+                },
+                Location: {
+                    City: (payload === null || payload === void 0 ? void 0 : payload.city) || '',
+                    Country: (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),
+                },
+                Application: {
+                    AppTitle: (_b = (_a = payload === null || payload === void 0 ? void 0 : payload.appTitle) !== null && _a !== void 0 ? _a : appName) !== null && _b !== void 0 ? _b : trackerName,
+                    AppVersion: (_c = payload === null || payload === void 0 ? void 0 : payload.appVersion) !== null && _c !== void 0 ? _c : appVersion,
+                    ClientSdkVersion: (_d = payload === null || payload === void 0 ? void 0 : payload.clientSdkVersion) !== null && _d !== void 0 ? _d : trackerName,
+                },
+            },
+            Events: [
+                {
+                    EventType: eventName,
+                    Timestamp: timestamp,
+                    Session: {
+                        Id: sessionId,
+                        StartTimestamp: timestamp,
+                        EndTimestamp: timestamp,
+                        Duration: 0,
+                    },
+                    Attributes: attributes,
+                    Metrics: metrics,
+                },
+            ],
+        },
+    };
+}
+export function createEsriPlugin({ trackerName, appName, appId, appVersion, userPoolID, fips, }) {
+    const url = ESRI_ENDPOINT_URL(appId);
+    let isDisabled = false;
+    let hasWarned = false;
+    const warnOnce = (message, details) => {
+        if (hasWarned) {
+            return;
+        }
+        hasWarned = true;
+        warnLog(message, details);
+    };
+    debugLog('createEsriPlugin initialized', {
+        trackerName,
+        hasUrl: Boolean(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,
+        });
+    }
+    return {
+        track: (eventName, payload) => {
+            if (isDisabled || !url || !userPoolID) {
+                debugLog('Skipping esri track call', {
+                    eventName,
+                    reason: 'plugin-disabled',
+                });
+                return false;
+            }
+            debugLog('Sending esri endpoint event', {
+                eventName,
+                trackerName,
+                url,
+            });
+            void getCredentials(userPoolID, { fips })
+                .then((credentials) => {
+                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,
+                });
+                return client.fetch(url, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify(buildBatchEventPayload({
+                        eventName,
+                        payload: payload,
+                        trackerName,
+                        appName,
+                        appVersion,
+                    })),
+                });
+            })
+                .then(() => {
+                debugLog('Endpoint event sent', {
+                    eventName,
+                    trackerName,
+                });
+            })
+                .catch((error) => {
+                isDisabled = true;
+                warnOnce('Esri telemetry disabled after endpoint track failure', {
+                    eventName,
+                    trackerName,
+                    message: (error === null || error === void 0 ? void 0 : error.message) || String(error),
+                });
+            });
+            return true;
+        },
+    };
+}
+//# sourceMappingURL=esri.js.map

package/dist/esm/plugins/esri.js.map

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

package/dist/esm/plugins/esri.test.js

@@ -0,0 +1,161 @@
+import { createEsriPlugin } from './esri';
+import { AwsClient } from 'aws4fetch';
+import { getCredentials } from '../auth';
+const ESRI_ENDPOINT = 'https://tedev.arcgis.com/v1/apps/app-id/events';
+jest.mock('aws4fetch', () => ({
+    AwsClient: jest.fn(),
+}));
+jest.mock('../auth', () => ({
+    getCredentials: jest.fn(),
+}));
+const AwsClientMock = AwsClient;
+const getCredentialsMock = getCredentials;
+describe('esri plugin', () => {
+    let signedFetchMock;
+    let warnSpy;
+    beforeEach(() => {
+        signedFetchMock = jest.fn().mockResolvedValue({ ok: true, status: 200 });
+        AwsClientMock.mockReset();
+        AwsClientMock.mockImplementation(() => ({
+            fetch: signedFetchMock,
+        }));
+        getCredentialsMock.mockReset();
+        getCredentialsMock.mockResolvedValue({
+            AccessKeyId: 'akid',
+            SecretKey: 'secret',
+            SessionToken: 'token',
+        });
+        warnSpy = jest.spyOn(console, 'warn').mockImplementation(() => undefined);
+    });
+    afterEach(() => {
+        jest.restoreAllMocks();
+        delete globalThis.fetch;
+    });
+    test('returns false and warns once when userPoolID is missing', () => {
+        const plugin = createEsriPlugin({
+            trackerName: 'amazon',
+            appId: 'app-id',
+        });
+        const first = plugin.track('pageView', { path: '/home' });
+        const second = plugin.track('event', { name: 'test' });
+        expect(first).toBe(false);
+        expect(second).toBe(false);
+        expect(warnSpy).toHaveBeenCalledTimes(1);
+        expect(getCredentialsMock).not.toHaveBeenCalled();
+        expect(signedFetchMock).not.toHaveBeenCalled();
+    });
+    test('sends BatchEvent payload envelope with expected field casing', async () => {
+        globalThis.fetch = jest.fn();
+        jest.spyOn(Date, 'now').mockReturnValue(1716134400000);
+        jest.spyOn(Math, 'random').mockReturnValue(0.5);
+        const plugin = createEsriPlugin({
+            trackerName: 'amazon',
+            appName: 'ArcGIS Telemetry',
+            appVersion: '5.1.3',
+            appId: 'app-id',
+            userPoolID: 'pool-id',
+            fips: true,
+        });
+        const result = plugin.track('pageView', {
+            pageUrl: '/home',
+            count: 2,
+            enabled: true,
+            city: 'Redlands',
+            country: 'US',
+            lat: '34.056',
+            lon: '-117.195',
+        });
+        expect(result).toBe(true);
+        await Promise.resolve();
+        await Promise.resolve();
+        expect(getCredentialsMock).toHaveBeenCalledWith('pool-id', { fips: true });
+        expect(AwsClientMock).toHaveBeenCalledWith({
+            accessKeyId: 'akid',
+            secretAccessKey: 'secret',
+            sessionToken: 'token',
+            service: 'execute-api',
+            region: 'us-east-1',
+        });
+        expect(signedFetchMock).toHaveBeenCalledTimes(1);
+        const [url, request] = signedFetchMock.mock.calls[0];
+        expect(url).toBe(ESRI_ENDPOINT);
+        expect(request.method).toBe('POST');
+        expect(request.headers).toEqual({
+            'Content-Type': 'application/json',
+        });
+        const body = JSON.parse(request.body);
+        expect(body.BatchEvent.Endpoint.Attributes).toBeUndefined();
+        expect(body.BatchEvent.Endpoint.Metrics).toBeUndefined();
+        expect(body).toEqual(expect.objectContaining({
+            BatchEvent: expect.objectContaining({
+                Endpoint: expect.objectContaining({
+                    Id: expect.any(String),
+                    Device: {
+                        Make: '',
+                        Model: '',
+                    },
+                    Location: {
+                        City: 'Redlands',
+                        Country: 'US',
+                        Lat: 34.056,
+                        Lon: -117.195,
+                    },
+                    Application: {
+                        AppTitle: 'ArcGIS Telemetry',
+                        AppVersion: '5.1.3',
+                        ClientSdkVersion: 'amazon',
+                    },
+                }),
+                Events: [
+                    expect.objectContaining({
+                        EventType: 'pageView',
+                        Timestamp: expect.any(String),
+                        Session: expect.objectContaining({
+                            Id: expect.any(String),
+                            StartTimestamp: expect.any(String),
+                            EndTimestamp: expect.any(String),
+                            Duration: 0,
+                        }),
+                        Attributes: {
+                            pageUrl: '/home',
+                            enabled: 'true',
+                        },
+                        Metrics: {
+                            count: 2,
+                        },
+                    }),
+                ],
+            }),
+        }));
+    });
+    test('uses esri endpoint url built from app id', async () => {
+        globalThis.fetch = jest.fn();
+        const plugin = createEsriPlugin({
+            trackerName: 'amazon',
+            appId: 'app-id',
+            userPoolID: 'pool-id',
+        });
+        expect(plugin.track('pageView', { pageUrl: '/override' })).toBe(true);
+        await Promise.resolve();
+        await Promise.resolve();
+        const [url] = signedFetchMock.mock.calls[0];
+        expect(url).toBe(ESRI_ENDPOINT);
+    });
+    test('disables telemetry after a send failure and warns only once', async () => {
+        globalThis.fetch = jest.fn();
+        signedFetchMock.mockRejectedValue(new Error('boom'));
+        const plugin = createEsriPlugin({
+            trackerName: 'amazon',
+            appId: 'app-id',
+            userPoolID: 'pool-id',
+        });
+        expect(plugin.track('pageView', { path: '/home' })).toBe(true);
+        await Promise.resolve();
+        await Promise.resolve();
+        await new Promise((resolve) => process.nextTick(resolve));
+        expect(warnSpy).toHaveBeenCalledTimes(1);
+        expect(plugin.track('event', { name: 'after-failure' })).toBe(false);
+        expect(warnSpy).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=esri.test.js.map

package/dist/esm/plugins/esri.test.js.map

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

package/dist/esm/plugins/pinpoint.js

@@ -0,0 +1,163 @@
+import { AwsClient } from 'aws4fetch';
+import { storage } from '@esri/telemetry';
+import { getCredentials } from '../auth';
+import { PINPOINT_ENDPOINT_KEY, DEFAULT_PINPOINT_REGION, LOG_PREFIX, } from './shared';
+function isDebugEnabled() {
+    var _a;
+    const processEnv = typeof globalThis !== 'undefined'
+        ? (_a = globalThis.process) === null || _a === void 0 ? void 0 : _a.env
+        : undefined;
+    return ((processEnv === null || processEnv === void 0 ? void 0 : processEnv.TELEMETRY_AMAZON_DEBUG) === 'true' ||
+        (processEnv === null || processEnv === void 0 ? void 0 : processEnv.NODE_ENV) === 'development');
+}
+function debugLog(message, details) {
+    if (!isDebugEnabled() || typeof console === 'undefined') {
+        return;
+    }
+    if (details && typeof console.debug === 'function') {
+        console.debug(`${LOG_PREFIX} ${message}`, details);
+        return;
+    }
+    if (typeof console.debug === 'function') {
+        console.debug(`${LOG_PREFIX} ${message}`);
+    }
+}
+function warnLog(message, details) {
+    if (typeof console === 'undefined' || typeof console.warn !== 'function') {
+        return;
+    }
+    if (details) {
+        console.warn(`${LOG_PREFIX} ${message}`, details);
+        return;
+    }
+    console.warn(`${LOG_PREFIX} ${message}`);
+}
+function getEndpointId() {
+    const cached = storage.get(PINPOINT_ENDPOINT_KEY);
+    if (cached && typeof cached === 'object' && cached.endpointId) {
+        return cached.endpointId;
+    }
+    if (typeof cached === 'string') {
+        return cached;
+    }
+    const generated = `telemetry-${Date.now()}-${Math.random()
+        .toString(16)
+        .slice(2)}`;
+    storage.set(PINPOINT_ENDPOINT_KEY, { endpointId: generated });
+    return generated;
+}
+function buildEventData(payload) {
+    const Attributes = {};
+    const Metrics = {};
+    Object.entries(payload || {}).forEach(([key, value]) => {
+        if (value === undefined || value === null || key === 'name') {
+            return;
+        }
+        if (typeof value === 'number' && Number.isFinite(value)) {
+            Metrics[key] = value;
+            return;
+        }
+        if (typeof value === 'string' || typeof value === 'boolean') {
+            Attributes[key] = [String(value)];
+            return;
+        }
+        if (Array.isArray(value)) {
+            Attributes[key] = value.map((item) => String(item));
+        }
+    });
+    return {
+        Attributes: Object.keys(Attributes).length ? Attributes : undefined,
+        Metrics: Object.keys(Metrics).length ? Metrics : undefined,
+    };
+}
+export function createPinpointPlugin({ appName, appVersion, appId, userPoolID, fips, region = DEFAULT_PINPOINT_REGION, }) {
+    debugLog('createPinpointPlugin initialized', {
+        appId,
+        region,
+        fips: Boolean(fips),
+        hasAppName: Boolean(appName),
+        hasAppVersion: Boolean(appVersion),
+    });
+    return {
+        track: (eventName, payload) => {
+            if (!appId || typeof fetch !== 'function') {
+                debugLog('Skipping Pinpoint track call', {
+                    eventName,
+                    reason: !appId ? 'missing-app-id' : 'fetch-unavailable',
+                });
+                return false;
+            }
+            const endpointId = getEndpointId();
+            const eventId = `${Date.now()}-${Math.random().toString(16).slice(2)}`;
+            const eventData = buildEventData(payload);
+            const host = fips
+                ? `pinpoint-fips.${region}.amazonaws.com`
+                : `pinpoint.${region}.amazonaws.com`;
+            const url = `https://${host}/v1/apps/${appId}/events`;
+            debugLog('Sending Pinpoint event', {
+                eventName,
+                endpointId,
+                appId,
+                region,
+                host,
+            });
+            void getCredentials(userPoolID, { fips })
+                .then((credentials) => {
+                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) {
+                    warnLog('Pinpoint credentials missing required key fields', {
+                        hasAccessKeyId: Boolean(accessKeyId),
+                        hasSecretAccessKey: Boolean(secretAccessKey),
+                    });
+                    throw new Error('Pinpoint credentials are missing required key fields.');
+                }
+                const client = new AwsClient({
+                    accessKeyId,
+                    secretAccessKey,
+                    sessionToken,
+                    service: 'mobiletargeting',
+                    region,
+                });
+                return client.fetch(url, {
+                    method: 'POST',
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify({
+                        BatchItem: {
+                            [endpointId]: {
+                                Endpoint: {
+                                    Address: endpointId,
+                                    ChannelType: 'CUSTOM',
+                                    Demographic: {
+                                        AppVersion: appVersion,
+                                        Make: appName,
+                                    },
+                                },
+                                Events: {
+                                    [eventId]: Object.assign({ EventType: eventName, Timestamp: new Date().toISOString() }, eventData),
+                                },
+                            },
+                        },
+                    }),
+                });
+            })
+                .then(() => {
+                debugLog('Pinpoint event sent', {
+                    eventName,
+                    endpointId,
+                });
+            })
+                .catch((error) => {
+                warnLog('Pinpoint track failed', {
+                    eventName,
+                    message: (error === null || error === void 0 ? void 0 : error.message) || String(error),
+                });
+            });
+            return true;
+        },
+    };
+}
+//# sourceMappingURL=pinpoint.js.map

package/dist/esm/plugins/pinpoint.js.map

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

package/dist/esm/plugins/shared.js

@@ -0,0 +1,74 @@
+// Shared utilities for plugins
+import { storage } from '@esri/telemetry';
+export const PINPOINT_ENDPOINT_KEY = 'TELEMETRY_PINPOINT_ENDPOINT_ID';
+export const DEFAULT_PINPOINT_REGION = 'us-east-1';
+export const LOG_PREFIX = '[telemetry-amazon]';
+export function isDebugEnabled() {
+    var _a;
+    const processEnv = typeof globalThis !== 'undefined'
+        ? (_a = globalThis.process) === null || _a === void 0 ? void 0 : _a.env
+        : undefined;
+    return ((processEnv === null || processEnv === void 0 ? void 0 : processEnv.TELEMETRY_AMAZON_DEBUG) === 'true' ||
+        (processEnv === null || processEnv === void 0 ? void 0 : processEnv.NODE_ENV) === 'development');
+}
+export function debugLog(message, details) {
+    if (!isDebugEnabled() || typeof console === 'undefined') {
+        return;
+    }
+    if (details && typeof console.debug === 'function') {
+        console.debug(`${LOG_PREFIX} ${message}`, details);
+        return;
+    }
+    if (typeof console.debug === 'function') {
+        console.debug(`${LOG_PREFIX} ${message}`);
+    }
+}
+export function warnLog(message, details) {
+    if (typeof console === 'undefined' || typeof console.warn !== 'function') {
+        return;
+    }
+    if (details) {
+        console.warn(`${LOG_PREFIX} ${message}`, details);
+        return;
+    }
+    console.warn(`${LOG_PREFIX} ${message}`);
+}
+export function getEndpointId() {
+    const cached = storage.get(PINPOINT_ENDPOINT_KEY);
+    if (cached && typeof cached === 'object' && cached.endpointId) {
+        return cached.endpointId;
+    }
+    if (typeof cached === 'string') {
+        return cached;
+    }
+    const generated = `telemetry-${Date.now()}-${Math.random()
+        .toString(16)
+        .slice(2)}`;
+    storage.set(PINPOINT_ENDPOINT_KEY, { endpointId: generated });
+    return generated;
+}
+export function buildEventData(payload) {
+    const Attributes = {};
+    const Metrics = {};
+    Object.entries(payload || {}).forEach(([key, value]) => {
+        if (value === undefined || value === null || key === 'name') {
+            return;
+        }
+        if (typeof value === 'number' && Number.isFinite(value)) {
+            Metrics[key] = value;
+            return;
+        }
+        if (typeof value === 'string' || typeof value === 'boolean') {
+            Attributes[key] = [String(value)];
+            return;
+        }
+        if (Array.isArray(value)) {
+            Attributes[key] = value.map((item) => String(item));
+        }
+    });
+    return {
+        Attributes: Object.keys(Attributes).length ? Attributes : undefined,
+        Metrics: Object.keys(Metrics).length ? Metrics : undefined,
+    };
+}
+//# sourceMappingURL=shared.js.map

package/dist/esm/plugins/shared.js.map

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

package/dist/node/create-page-view-log.js

@@ -17,7 +17,7 @@ function createPageViewLog({ page, previousPage = {}, options = {}, dimensionLoo
     const { referrer, title } = document || {};
     const { hostname, pathname } = window && window.location ? window.location : {};
     return Object.assign(Object.assign({ name: 'pageView', referrer,
-        hostname, path: page || pathname, pageUrl: page || pathname, pageName: title, previousPageUrl: previousPage.pageUrl, previousPageName: previousPage.pageName }, attributes), metrics);
+        hostname, path: page || pathname, pageUrl: page || pathname, pageName: title, previousPageUrl: previousPage === null || previousPage === void 0 ? void 0 : previousPage.pageUrl, previousPageName: previousPage === null || previousPage === void 0 ? void 0 : previousPage.pageName }, attributes), metrics);
 }
 exports.createPageViewLog = createPageViewLog;
 //# sourceMappingURL=create-page-view-log.js.map

package/dist/node/create-page-view-log.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-page-view-log.js","sourceRoot":"","sources":["../../src/create-page-view-log.ts"],"names":[],"mappings":";;;AAAA,+EAA0E;AAC1E,yEAAoE;AAGpE,SAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,YAAY,GAAG,EAAE,EACjB,OAAO,GAAG,EAAE,EACZ,eAAe,GAAG,EAAE,EACpB,YAAY,GAAG,EAAE,GAOlB;IACC,MAAM,OAAO,GAAG,IAAA,iDAAsB,EAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,IAAA,uDAAyB,EAAC;QAC3C,aAAa,EAAE,OAAO;QACtB,eAAe;QACf,WAAW,EAAE;YACX,UAAU;YACV,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;SAC7B;KACF,CAAC,CAAC;IAEH,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,QAAQ,IAAI,EAAE,CAAC;IAC3C,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAC1B,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAU,CAAC;IAE5D,qCACE,IAAI,EAAE,UAAU,EAChB,QAAQ;QACR,QAAQ,EACR,IAAI,EAAE,IAAI,IAAI,QAAQ,EACtB,OAAO,EAAE,IAAI,IAAI,QAAQ,EACzB,QAAQ,EAAE,KAAK,EACf,eAAe,EAAE,YAAY,CAAC,OAAO,EACrC,gBAAgB,EAAE,YAAY,CAAC,QAAQ,IACpC,UAAU,GACV,OAAO,EACV;AACJ,CAAC;AAxCD,8CAwCC"}
+{"version":3,"file":"create-page-view-log.js","sourceRoot":"","sources":["../../src/create-page-view-log.ts"],"names":[],"mappings":";;;AAAA,+EAA0E;AAC1E,yEAAoE;AAGpE,SAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,YAAY,GAAG,EAAE,EACjB,OAAO,GAAG,EAAE,EACZ,eAAe,GAAG,EAAE,EACpB,YAAY,GAAG,EAAE,GAOlB;IACC,MAAM,OAAO,GAAG,IAAA,iDAAsB,EAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,IAAA,uDAAyB,EAAC;QAC3C,aAAa,EAAE,OAAO;QACtB,eAAe;QACf,WAAW,EAAE;YACX,UAAU;YACV,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;SAC7B;KACF,CAAC,CAAC;IAEH,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,QAAQ,IAAI,EAAE,CAAC;IAC3C,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAC1B,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAE,EAAU,CAAC;IAE5D,qCACE,IAAI,EAAE,UAAU,EAChB,QAAQ;QACR,QAAQ,EACR,IAAI,EAAE,IAAI,IAAI,QAAQ,EACtB,OAAO,EAAE,IAAI,IAAI,QAAQ,EACzB,QAAQ,EAAE,KAAK,EACf,eAAe,EAAE,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,OAAO,EACtC,gBAAgB,EAAE,YAAY,aAAZ,YAAY,uBAAZ,YAAY,CAAE,QAAQ,IACrC,UAAU,GACV,OAAO,EACV;AACJ,CAAC;AAxCD,8CAwCC"}