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

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

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const esri_1 = require("./esri");
+const aws4fetch_1 = require("aws4fetch");
+const auth_1 = require("../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 = aws4fetch_1.AwsClient;
+const getCredentialsMock = auth_1.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 = (0, esri_1.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 = (0, esri_1.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 = (0, esri_1.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 = (0, esri_1.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/node/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/node/plugins/pinpoint.js

@@ -0,0 +1,167 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPinpointPlugin = void 0;
+const aws4fetch_1 = require("aws4fetch");
+const telemetry_1 = require("@esri/telemetry");
+const auth_1 = require("../auth");
+const shared_1 = require("./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(`${shared_1.LOG_PREFIX} ${message}`, details);
+        return;
+    }
+    if (typeof console.debug === 'function') {
+        console.debug(`${shared_1.LOG_PREFIX} ${message}`);
+    }
+}
+function warnLog(message, details) {
+    if (typeof console === 'undefined' || typeof console.warn !== 'function') {
+        return;
+    }
+    if (details) {
+        console.warn(`${shared_1.LOG_PREFIX} ${message}`, details);
+        return;
+    }
+    console.warn(`${shared_1.LOG_PREFIX} ${message}`);
+}
+function getEndpointId() {
+    const cached = telemetry_1.storage.get(shared_1.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)}`;
+    telemetry_1.storage.set(shared_1.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,
+    };
+}
+function createPinpointPlugin({ appName, appVersion, appId, userPoolID, fips, region = shared_1.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 (0, auth_1.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 aws4fetch_1.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;
+        },
+    };
+}
+exports.createPinpointPlugin = createPinpointPlugin;
+//# sourceMappingURL=pinpoint.js.map

package/dist/node/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/node/plugins/shared.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildEventData = exports.getEndpointId = exports.warnLog = exports.debugLog = exports.isDebugEnabled = exports.LOG_PREFIX = exports.DEFAULT_PINPOINT_REGION = exports.PINPOINT_ENDPOINT_KEY = void 0;
+// Shared utilities for plugins
+const telemetry_1 = require("@esri/telemetry");
+exports.PINPOINT_ENDPOINT_KEY = 'TELEMETRY_PINPOINT_ENDPOINT_ID';
+exports.DEFAULT_PINPOINT_REGION = 'us-east-1';
+exports.LOG_PREFIX = '[telemetry-amazon]';
+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');
+}
+exports.isDebugEnabled = isDebugEnabled;
+function debugLog(message, details) {
+    if (!isDebugEnabled() || typeof console === 'undefined') {
+        return;
+    }
+    if (details && typeof console.debug === 'function') {
+        console.debug(`${exports.LOG_PREFIX} ${message}`, details);
+        return;
+    }
+    if (typeof console.debug === 'function') {
+        console.debug(`${exports.LOG_PREFIX} ${message}`);
+    }
+}
+exports.debugLog = debugLog;
+function warnLog(message, details) {
+    if (typeof console === 'undefined' || typeof console.warn !== 'function') {
+        return;
+    }
+    if (details) {
+        console.warn(`${exports.LOG_PREFIX} ${message}`, details);
+        return;
+    }
+    console.warn(`${exports.LOG_PREFIX} ${message}`);
+}
+exports.warnLog = warnLog;
+function getEndpointId() {
+    const cached = telemetry_1.storage.get(exports.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)}`;
+    telemetry_1.storage.set(exports.PINPOINT_ENDPOINT_KEY, { endpointId: generated });
+    return generated;
+}
+exports.getEndpointId = getEndpointId;
+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,
+    };
+}
+exports.buildEventData = buildEventData;
+//# sourceMappingURL=shared.js.map

package/dist/node/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/types/create-page-view-log.d.ts

@@ -1,7 +1,7 @@
 import { LogPageViewPayload } from './types';
 export declare function createPageViewLog({ page, previousPage, options, dimensionLookup, metricLookup, }: {
     page: string;
-    previousPage?: Record<string, string>;
+    previousPage?: Record<string, string> | null;
     options: Record<string, any>;
     dimensionLookup: Record<string, any>;
     metricLookup: Record<string, number>;

package/dist/types/index.d.ts

@@ -1,21 +1,24 @@
-import { AnalyticsInstance } from 'analytics';
-import { AmazonTelemetryOptions, Dimensions, Metrics, IAmazon, PageViewOptions, EventOptions, ISetAccessPermissionsParams, IGetAccessPermissionsParams } from './types';
+import { AmazonTracker, AmazonTelemetryOptions, AmazonTelemetryEndpointMode, Dimensions, Metrics, IAmazon, PageViewOptions, EventOptions, ISetAccessPermissionsParams, IGetAccessPermissionsParams } from './types';
 /**
  * Amazon Telemetry
- * Supports Amazon Pinpoint
+ * Supports Pinpoint and Esri endpoint modes
  */
 export declare class Amazon implements IAmazon<Dimensions, Metrics> {
-    analytics: AnalyticsInstance;
+    analytics: AmazonTracker;
     name: string;
-    previousPage: any;
+    previousPage: {
+        pageUrl?: string;
+        pageName?: string;
+    };
     dimensions: Dimensions;
     metrics: Metrics;
     disabled: boolean;
     isInitialized: boolean;
+    mode: AmazonTelemetryEndpointMode;
     constructor(options: AmazonTelemetryOptions);
     init(): Promise<void>;
     static setAccessPermissions({ id, authentication, username, accessChangeset, }: ISetAccessPermissionsParams): Promise<import("@esri/arcgis-rest-portal").IUpdateItemResponse>;
     static getAccessPermissions({ id, authentication, }: IGetAccessPermissionsParams): Promise<Record<string, any>>;
-    logPageView(page: string, options?: PageViewOptions): void;
-    logEvent(event?: EventOptions): void;
+    logPageView(page: string, options?: PageViewOptions): boolean;
+    logEvent(event?: EventOptions): boolean;
 }

package/dist/types/plugins/esri.d.ts

@@ -0,0 +1,11 @@
+import { AmazonTracker } from '../types';
+declare type EsriPluginOptions = {
+    trackerName: string;
+    appId: string;
+    appName?: string;
+    appVersion?: string;
+    userPoolID?: string;
+    fips?: boolean;
+};
+export declare function createEsriPlugin({ trackerName, appName, appId, appVersion, userPoolID, fips, }: EsriPluginOptions): AmazonTracker;
+export {};

package/dist/types/plugins/esri.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/plugins/pinpoint.d.ts

@@ -0,0 +1,11 @@
+import { AmazonTracker } from '../types';
+declare type PinpointPluginOptions = {
+    appName?: string;
+    appVersion?: string;
+    appId?: string;
+    userPoolID: string;
+    fips?: boolean;
+    region?: string;
+};
+export declare function createPinpointPlugin({ appName, appVersion, appId, userPoolID, fips, region, }: PinpointPluginOptions): AmazonTracker;
+export {};

package/dist/types/plugins/shared.d.ts

@@ -0,0 +1,11 @@
+export declare const PINPOINT_ENDPOINT_KEY = "TELEMETRY_PINPOINT_ENDPOINT_ID";
+export declare const DEFAULT_PINPOINT_REGION = "us-east-1";
+export declare const LOG_PREFIX = "[telemetry-amazon]";
+export declare function isDebugEnabled(): boolean;
+export declare function debugLog(message: string, details?: Record<string, any>): void;
+export declare function warnLog(message: string, details?: Record<string, any>): void;
+export declare function getEndpointId(): string;
+export declare function buildEventData(payload: Record<string, any>): {
+    Attributes?: Record<string, string[]>;
+    Metrics?: Record<string, number>;
+};

package/dist/types/types.d.ts

@@ -1,5 +1,4 @@
-import { AnalyticsInstance } from 'analytics';
-import type { ArcGISIdentityManager } from "@esri/arcgis-rest-request";
+import type { ArcGISIdentityManager } from '@esri/arcgis-rest-request';
 export declare type GenericObject = {
     [key: string]: any;
 };
@@ -11,18 +10,17 @@ export interface ISetAccessPermissionsParams extends IGetAccessPermissionsParams
     username: string;
     accessChangeset: IAccessChangeset[];
 }
-export interface IGetAccessPermissionsParams {
-    id: string;
-    authentication: ArcGISIdentityManager;
-}
 declare type AccessTargetProperties = 'public';
 export interface IAccessChangeset {
     action: 'add' | 'remove';
     targetProperty: AccessTargetProperties;
     ids?: string[];
 }
+export interface AmazonTracker {
+    track(eventName: string, payload: Record<string, any>): boolean;
+}
 export interface IAmazon<D, M> {
-    analytics: AnalyticsInstance;
+    analytics: AmazonTracker;
     name: string;
     previousPage: {
         pageUrl?: string;
@@ -32,8 +30,8 @@ export interface IAmazon<D, M> {
     dimensions: D;
     metrics: M;
     init(): Promise<void>;
-    logPageView: (page: string, options?: PageViewOptions) => void;
-    logEvent: (event?: EventOptions) => void;
+    logPageView: (page: string, options?: PageViewOptions) => boolean;
+    logEvent: (event?: EventOptions) => boolean;
 }
 export declare type Dimensions = GenericObject;
 export declare type Metrics = GenericObject;
@@ -51,11 +49,20 @@ export declare type AmazonApp = {
     id?: string;
     version?: string;
 };
-export declare type AmazonTelemetryOptions = {
+export declare type AmazonTelemetryPinpointOptions = {
+    userPoolID: string;
+    app?: AmazonApp;
+    fips?: boolean;
+    mode?: 'pinpoint';
+};
+export declare type AmazonTelemetryEsriOptions = {
     userPoolID: string;
     app?: AmazonApp;
     fips?: boolean;
+    mode: 'esri';
 };
+export declare type AmazonTelemetryOptions = AmazonTelemetryPinpointOptions | AmazonTelemetryEsriOptions;
+export declare type AmazonTelemetryEndpointMode = 'pinpoint' | 'esri';
 export declare type LogPageViewPayload = {
     name: string;
     referrer: string;