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

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":";;;AAAA,yCAAsC;AACtC,+CAA0C;AAC1C,kCAAyC;AAGzC,qCAIkB;AAWlB,SAAS,cAAc;;IACrB,MAAM,UAAU,GACd,OAAO,UAAU,KAAK,WAAW;QAC/B,CAAC,CAAC,MAAC,UAAkB,CAAC,OAAO,0CAAE,GAAG;QAClC,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO,CACL,CAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,sBAAsB,MAAK,MAAM;QAC7C,CAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,QAAQ,MAAK,aAAa,CACvC,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,OAAe,EAAE,OAA6B;IAC9D,IAAI,CAAC,cAAc,EAAE,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE;QACvD,OAAO;KACR;IAED,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU,EAAE;QAClD,OAAO,CAAC,KAAK,CAAC,GAAG,mBAAU,IAAI,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO;KACR;IAED,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,UAAU,EAAE;QACvC,OAAO,CAAC,KAAK,CAAC,GAAG,mBAAU,IAAI,OAAO,EAAE,CAAC,CAAC;KAC3C;AACH,CAAC;AAED,SAAS,OAAO,CAAC,OAAe,EAAE,OAA6B;IAC7D,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE;QACxE,OAAO;KACR;IAED,IAAI,OAAO,EAAE;QACX,OAAO,CAAC,IAAI,CAAC,GAAG,mBAAU,IAAI,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO;KACR;IAED,OAAO,CAAC,IAAI,CAAC,GAAG,mBAAU,IAAI,OAAO,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,aAAa;IACpB,MAAM,MAAM,GAAG,mBAAO,CAAC,GAAG,CAAC,8BAAqB,CAAC,CAAC;IAClD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,EAAE;QAC7D,OAAO,MAAM,CAAC,UAAU,CAAC;KAC1B;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;QAC9B,OAAO,MAAM,CAAC;KACf;IAED,MAAM,SAAS,GAAG,aAAa,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE;SACvD,QAAQ,CAAC,EAAE,CAAC;SACZ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACd,mBAAO,CAAC,GAAG,CAAC,8BAAqB,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,cAAc,CAAC,OAA4B;IAIlD,MAAM,UAAU,GAA6B,EAAE,CAAC;IAChD,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,MAAM,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACrD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,EAAE;YAC3D,OAAO;SACR;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;YACvD,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACrB,OAAO;SACR;QAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE;YAC3D,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAClC,OAAO;SACR;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;YACxB,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;SACrD;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;QACnE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;KAC3D,CAAC;AACJ,CAAC;AAED,SAAgB,oBAAoB,CAAC,EACnC,OAAO,EACP,UAAU,EACV,KAAK,EACL,UAAU,EACV,IAAI,EACJ,MAAM,GAAG,gCAAuB,GACV;IACtB,QAAQ,CAAC,kCAAkC,EAAE;QAC3C,KAAK;QACL,MAAM;QACN,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC;QACnB,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC;QAC5B,aAAa,EAAE,OAAO,CAAC,UAAU,CAAC;KACnC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,EAAE,CAAC,SAAiB,EAAE,OAA4B,EAAW,EAAE;YAClE,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE;gBACzC,QAAQ,CAAC,8BAA8B,EAAE;oBACvC,SAAS;oBACT,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,mBAAmB;iBACxD,CAAC,CAAC;gBACH,OAAO,KAAK,CAAC;aACd;YAED,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,MAAM,SAAS,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,IAAI;gBACf,CAAC,CAAC,iBAAiB,MAAM,gBAAgB;gBACzC,CAAC,CAAC,YAAY,MAAM,gBAAgB,CAAC;YACvC,MAAM,GAAG,GAAG,WAAW,IAAI,YAAY,KAAK,SAAS,CAAC;YAEtD,QAAQ,CAAC,wBAAwB,EAAE;gBACjC,SAAS;gBACT,UAAU;gBACV,KAAK;gBACL,MAAM;gBACN,IAAI;aACL,CAAC,CAAC;YAEH,KAAK,IAAA,qBAAc,EAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC;iBACtC,IAAI,CAAC,CAAC,WAAW,EAAE,EAAE;gBACpB,MAAM,WAAW,GACf,CAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,WAAW,MAAI,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,WAAW,CAAA,CAAC;gBACvD,MAAM,eAAe,GACnB,CAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,SAAS,MAAI,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,eAAe,CAAA,CAAC;gBACzD,MAAM,YAAY,GAChB,CAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,YAAY,MAAI,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,YAAY,CAAA,CAAC;gBAEzD,IAAI,CAAC,WAAW,IAAI,CAAC,eAAe,EAAE;oBACpC,OAAO,CAAC,kDAAkD,EAAE;wBAC1D,cAAc,EAAE,OAAO,CAAC,WAAW,CAAC;wBACpC,kBAAkB,EAAE,OAAO,CAAC,eAAe,CAAC;qBAC7C,CAAC,CAAC;oBACH,MAAM,IAAI,KAAK,CACb,uDAAuD,CACxD,CAAC;iBACH;gBAED,MAAM,MAAM,GAAG,IAAI,qBAAS,CAAC;oBAC3B,WAAW;oBACX,eAAe;oBACf,YAAY;oBACZ,OAAO,EAAE,iBAAiB;oBAC1B,MAAM;iBACP,CAAC,CAAC;gBAEH,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;oBACvB,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,cAAc,EAAE,kBAAkB;qBACnC;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;wBACnB,SAAS,EAAE;4BACT,CAAC,UAAU,CAAC,EAAE;gCACZ,QAAQ,EAAE;oCACR,OAAO,EAAE,UAAU;oCACnB,WAAW,EAAE,QAAQ;oCACrB,WAAW,EAAE;wCACX,UAAU,EAAE,UAAU;wCACtB,IAAI,EAAE,OAAO;qCACd;iCACF;gCACD,MAAM,EAAE;oCACN,CAAC,OAAO,CAAC,kBACP,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,IAChC,SAAS,CACb;iCACF;6BACF;yBACF;qBACF,CAAC;iBACH,CAAC,CAAC;YACL,CAAC,CAAC;iBACD,IAAI,CAAC,GAAG,EAAE;gBACT,QAAQ,CAAC,qBAAqB,EAAE;oBAC9B,SAAS;oBACT,UAAU;iBACX,CAAC,CAAC;YACL,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,KAAU,EAAE,EAAE;gBACpB,OAAO,CAAC,uBAAuB,EAAE;oBAC/B,SAAS;oBACT,OAAO,EAAE,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,OAAO,KAAI,MAAM,CAAC,KAAK,CAAC;iBACzC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEL,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC;AAjHD,oDAiHC"}

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,10 @@
+import { AmazonTracker } from '../types';
+declare type EsriPluginOptions = {
+    url?: string;
+    headers?: Record<string, string>;
+    trackerName: string;
+    appName?: string;
+    appVersion?: string;
+};
+export declare function createEsriPlugin({ url, headers, trackerName, appName, appVersion, }: 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;
@@ -55,6 +53,13 @@ export declare type AmazonTelemetryOptions = {
     userPoolID: string;
     app?: AmazonApp;
     fips?: boolean;
+    mode?: AmazonTelemetryEndpointMode;
+    endpoint?: AmazonTelemetryEndpointOptions;
+};
+export declare type AmazonTelemetryEndpointMode = 'pinpoint' | 'esri';
+export declare type AmazonTelemetryEndpointOptions = {
+    url?: string;
+    headers?: Record<string, string>;
 };
 export declare type LogPageViewPayload = {
     name: string;