@aws-amplify/analytics 7.0.1-console-preview.8f82e46.0 → 7.0.1-console-preview.b278dcb.0

package/lib/types/index.d.ts

@@ -1,4 +1,3 @@
-export { AutoTrackAttributes, AutoTrackEventOpts, AutoTrackPageViewOpts, AutoTrackSessionOpts, EventAttributes, EventMetrics, EventTrackOpts, PageViewTrackOpts, SessionTrackOpts, } from './analytics';
 export { AnalyticsServiceOptions } from './options';
-export { AnalyticsIdentifyUserInput } from './inputs';
+export { AnalyticsConfigureAutoTrackInput, AnalyticsIdentifyUserInput, } from './inputs';
 export { KinesisStream, KinesisShard, KinesisEventData } from './kinesis';

package/lib/types/inputs.d.ts

@@ -1,5 +1,6 @@
 import { UserProfile } from '@aws-amplify/core';
 import { AnalyticsServiceOptions } from '.';
+import { SessionTrackingOptions, PageViewTrackingOptions, EventTrackingOptions } from './trackers';
 /**
  * Input type for `identifyUser`.
  */
@@ -15,7 +16,20 @@ export type AnalyticsIdentifyUserInput<ServiceOptions extends AnalyticsServiceOp
     /**
      * Options to be passed to the API.
      */
-    options?: {
-        serviceOptions?: ServiceOptions;
-    };
+    options?: ServiceOptions;
 };
+/**
+ * Input type for `configureAutoTrack`.
+ */
+export type AnalyticsConfigureAutoTrackInput = {
+    enable: boolean;
+} & ({
+    type: 'session';
+    options?: SessionTrackingOptions;
+} | {
+    type: 'pageView';
+    options?: PageViewTrackingOptions;
+} | {
+    type: 'event';
+    options?: EventTrackingOptions;
+});

package/lib/types/options.d.ts

@@ -1,4 +1,4 @@
 /**
  * Base type for service options.
  */
-export type AnalyticsServiceOptions = any;
+export type AnalyticsServiceOptions = Record<string, unknown>;

package/lib/types/trackers.d.ts

@@ -0,0 +1,22 @@
+export type SessionTrackingOptions = {
+    attributes?: TrackerAttributes;
+};
+export type PageViewTrackingOptions = {
+    attributes?: TrackerAttributes;
+    eventName?: string;
+    urlProvider?: () => string;
+    appType?: 'multiPage' | 'singlePage';
+};
+export type EventTrackingOptions = {
+    attributes?: TrackerAttributes;
+    events?: DOMEvent[];
+    selectorPrefix?: string;
+};
+export type TrackerType = 'event' | 'pageView' | 'session';
+export type TrackerAttributes = Record<string, string>;
+export type TrackerEventRecorder = (eventName: string, attributes: TrackerAttributes) => void;
+export type DOMEvent = keyof GlobalEventHandlersEventMap;
+export interface TrackerInterface {
+    configure(eventRecorder: TrackerEventRecorder, options?: object): void;
+    cleanup(): void;
+}

package/lib/utils/eventBuffer/EventBuffer.js

@@ -4,8 +4,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventBuffer = void 0;
 var tslib_1 = require("tslib");
-var utils_1 = require("@aws-amplify/core/internals/utils");
-var logger = new utils_1.ConsoleLogger('EventBuffer');
+var core_1 = require("@aws-amplify/core");
+var logger = new core_1.ConsoleLogger('EventBuffer');
 var EventBuffer = /** @class */ (function () {
     function EventBuffer(config, getAnalyticsClient) {
         this.list = [];

package/lib/utils/index.d.ts

@@ -3,3 +3,5 @@ export { groupBy } from './groupBy';
 export { EventBuffer, IAnalyticsClient, EventBufferConfig, } from './eventBuffer';
 export { enableAnalytics, disableAnalytics, isAnalyticsEnabled, } from './statusHelpers';
 export { getAnalyticsUserAgent, getAnalyticsUserAgentString, } from './userAgent';
+export { updateProviderTrackers } from './trackerHelpers';
+export { validateTrackerConfiguration } from './trackerConfigHelpers';

package/lib/utils/index.js

@@ -2,7 +2,7 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAnalyticsUserAgentString = exports.getAnalyticsUserAgent = exports.isAnalyticsEnabled = exports.disableAnalytics = exports.enableAnalytics = exports.EventBuffer = exports.groupBy = exports.resolveCredentials = void 0;
+exports.validateTrackerConfiguration = exports.updateProviderTrackers = exports.getAnalyticsUserAgentString = exports.getAnalyticsUserAgent = exports.isAnalyticsEnabled = exports.disableAnalytics = exports.enableAnalytics = exports.EventBuffer = exports.groupBy = exports.resolveCredentials = void 0;
 var resolveCredentials_1 = require("./resolveCredentials");
 Object.defineProperty(exports, "resolveCredentials", { enumerable: true, get: function () { return resolveCredentials_1.resolveCredentials; } });
 var groupBy_1 = require("./groupBy");
@@ -16,3 +16,7 @@ Object.defineProperty(exports, "isAnalyticsEnabled", { enumerable: true, get: fu
 var userAgent_1 = require("./userAgent");
 Object.defineProperty(exports, "getAnalyticsUserAgent", { enumerable: true, get: function () { return userAgent_1.getAnalyticsUserAgent; } });
 Object.defineProperty(exports, "getAnalyticsUserAgentString", { enumerable: true, get: function () { return userAgent_1.getAnalyticsUserAgentString; } });
+var trackerHelpers_1 = require("./trackerHelpers");
+Object.defineProperty(exports, "updateProviderTrackers", { enumerable: true, get: function () { return trackerHelpers_1.updateProviderTrackers; } });
+var trackerConfigHelpers_1 = require("./trackerConfigHelpers");
+Object.defineProperty(exports, "validateTrackerConfiguration", { enumerable: true, get: function () { return trackerConfigHelpers_1.validateTrackerConfiguration; } });

package/lib/utils/trackerConfigHelpers.d.ts

@@ -0,0 +1,5 @@
+import { AnalyticsConfigureAutoTrackInput } from '../types';
+/**
+ * Validates tracker configuration.
+ */
+export declare const validateTrackerConfiguration: (input: AnalyticsConfigureAutoTrackInput) => void;

package/lib/utils/trackerConfigHelpers.js

@@ -0,0 +1,15 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTrackerConfiguration = void 0;
+var errors_1 = require("../errors");
+/**
+ * Validates tracker configuration.
+ */
+var validateTrackerConfiguration = function (input) {
+    (0, errors_1.assertValidationError)(input.type === 'event' ||
+        input.type === 'pageView' ||
+        input.type === 'session', errors_1.AnalyticsValidationErrorCode.InvalidTracker);
+};
+exports.validateTrackerConfiguration = validateTrackerConfiguration;

package/lib/utils/trackerConfigHelpers.native.d.ts

@@ -0,0 +1,5 @@
+import { AnalyticsConfigureAutoTrackInput } from '../types';
+/**
+ * Validates tracker configuration.
+ */
+export declare const validateTrackerConfiguration: (input: AnalyticsConfigureAutoTrackInput) => void;

package/lib/utils/trackerConfigHelpers.native.js

@@ -0,0 +1,14 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTrackerConfiguration = void 0;
+var errors_1 = require("../errors");
+/**
+ * Validates tracker configuration.
+ */
+var validateTrackerConfiguration = function (input) {
+    // React Native only supports session tracking
+    (0, errors_1.assertValidationError)(input.type === 'session', errors_1.AnalyticsValidationErrorCode.UnsupportedPlatform);
+};
+exports.validateTrackerConfiguration = validateTrackerConfiguration;

package/lib/utils/trackerHelpers.d.ts

@@ -0,0 +1,9 @@
+import { TrackerEventRecorder, TrackerInterface, TrackerType } from '../types/trackers';
+import { ConfigureAutoTrackInput } from '../providers/pinpoint';
+/**
+ * Updates a provider's trackers as appropriate for the provided auto-track configuration.
+ *
+ * @remark
+ * This utility will mutate the provider's configured trackers via `providerTrackers`.
+ */
+export declare const updateProviderTrackers: (input: ConfigureAutoTrackInput, providerEventRecorder: TrackerEventRecorder, providerTrackers: Partial<Record<TrackerType, TrackerInterface>>) => void;

package/lib/utils/trackerHelpers.js

@@ -0,0 +1,44 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateProviderTrackers = void 0;
+var trackers_1 = require("../trackers");
+/**
+ * Updates a provider's trackers as appropriate for the provided auto-track configuration.
+ *
+ * @remark
+ * This utility will mutate the provider's configured trackers via `providerTrackers`.
+ */
+var updateProviderTrackers = function (input, providerEventRecorder, providerTrackers) {
+    var trackerInstance;
+    var trackerType = input.type;
+    var currentTracker = providerTrackers[trackerType];
+    // Check if the tracker was disabled & should be cleaned up
+    if (!input.enable) {
+        if (currentTracker) {
+            currentTracker.cleanup();
+            delete providerTrackers[trackerType];
+        }
+        return;
+    }
+    // Re-configure the existing tracker, or create & configure an instance if it doesn't exist yet
+    if (currentTracker) {
+        currentTracker.configure(providerEventRecorder, input.options);
+        return;
+    }
+    // Create a new tracker instance for the type
+    if (trackerType === 'event') {
+        trackerInstance = new trackers_1.EventTracker(providerEventRecorder, input.options);
+    }
+    else if (trackerType === 'pageView') {
+        trackerInstance = new trackers_1.PageViewTracker(providerEventRecorder, input.options);
+    }
+    else if (trackerType === 'session') {
+        trackerInstance = new trackers_1.SessionTracker(providerEventRecorder, input.options);
+    }
+    if (trackerInstance) {
+        providerTrackers[trackerType] = trackerInstance;
+    }
+};
+exports.updateProviderTrackers = updateProviderTrackers;

package/lib-esm/errors/validation.d.ts

@@ -4,6 +4,8 @@ export declare enum AnalyticsValidationErrorCode {
     NoCredentials = "NoCredentials",
     NoEventName = "NoEventName",
     NoRegion = "NoRegion",
+    InvalidTracker = "InvalidTracker",
+    UnsupportedPlatform = "UnsupportedPlatform",
     NoTrackingId = "NoTrackingId",
     InvalidFlushSize = "InvalidFlushSize"
 }

package/lib-esm/errors/validation.js

@@ -7,6 +7,8 @@ export var AnalyticsValidationErrorCode;
     AnalyticsValidationErrorCode["NoCredentials"] = "NoCredentials";
     AnalyticsValidationErrorCode["NoEventName"] = "NoEventName";
     AnalyticsValidationErrorCode["NoRegion"] = "NoRegion";
+    AnalyticsValidationErrorCode["InvalidTracker"] = "InvalidTracker";
+    AnalyticsValidationErrorCode["UnsupportedPlatform"] = "UnsupportedPlatform";
     AnalyticsValidationErrorCode["NoTrackingId"] = "NoTrackingId";
     AnalyticsValidationErrorCode["InvalidFlushSize"] = "InvalidFlushSize";
 })(AnalyticsValidationErrorCode || (AnalyticsValidationErrorCode = {}));
@@ -23,6 +25,12 @@ export var validationErrorMap = (_a = {},
     _a[AnalyticsValidationErrorCode.NoRegion] = {
         message: 'Missing region.',
     },
+    _a[AnalyticsValidationErrorCode.InvalidTracker] = {
+        message: 'Invalid tracker type specified.',
+    },
+    _a[AnalyticsValidationErrorCode.UnsupportedPlatform] = {
+        message: 'Only session tracking is supported on React Native.',
+    },
     _a[AnalyticsValidationErrorCode.InvalidFlushSize] = {
         message: 'Invalid FlushSize, it should be smaller than BufferSize',
     },

package/lib-esm/index.d.ts

@@ -1,3 +1,3 @@
-export { record, identifyUser, RecordInput, IdentifyUserInput, flushEvents, } from './providers/pinpoint';
+export { record, identifyUser, configureAutoTrack, flushEvents, RecordInput, IdentifyUserInput, ConfigureAutoTrackInput, } from './providers/pinpoint';
 export { enable, disable } from './apis';
 export { AnalyticsError } from './errors';

package/lib-esm/index.js

@@ -1,5 +1,5 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-export { record, identifyUser, flushEvents, } from './providers/pinpoint';
+export { record, identifyUser, configureAutoTrack, flushEvents, } from './providers/pinpoint';
 export { enable, disable } from './apis';
 export { AnalyticsError } from './errors';

package/lib-esm/providers/kinesis/apis/flushEvents.js

@@ -3,7 +3,8 @@
 import { resolveConfig } from '../utils/resolveConfig';
 import { getAnalyticsUserAgentString, resolveCredentials, } from '../../../utils';
 import { getEventBuffer } from '../utils/getEventBuffer';
-import { AnalyticsAction, ConsoleLogger, } from '@aws-amplify/core/internals/utils';
+import { AnalyticsAction } from '@aws-amplify/core/internals/utils';
+import { ConsoleLogger } from '@aws-amplify/core';
 var logger = new ConsoleLogger('Kinesis');
 /**
  * Flushes all buffered Kinesis events to the service.

package/lib-esm/providers/kinesis/apis/record.js

@@ -4,7 +4,8 @@ import { getEventBuffer } from '../utils/getEventBuffer';
 import { resolveConfig } from '../utils/resolveConfig';
 import { getAnalyticsUserAgentString, isAnalyticsEnabled, resolveCredentials, } from '../../../utils';
 import { fromUtf8 } from '@smithy/util-utf8';
-import { AnalyticsAction, ConsoleLogger, } from '@aws-amplify/core/internals/utils';
+import { AnalyticsAction } from '@aws-amplify/core/internals/utils';
+import { ConsoleLogger } from '@aws-amplify/core';
 var logger = new ConsoleLogger('Kinesis');
 export var record = function (_a) {
     var streamName = _a.streamName, partitionKey = _a.partitionKey, data = _a.data;

package/lib-esm/providers/kinesis-firehose/apis/flushEvents.js

@@ -2,7 +2,8 @@
 // SPDX-License-Identifier: Apache-2.0
 import { getEventBuffer, resolveConfig } from '../utils';
 import { getAnalyticsUserAgentString, resolveCredentials, } from '../../../utils';
-import { AnalyticsAction, ConsoleLogger, } from '@aws-amplify/core/internals/utils';
+import { AnalyticsAction } from '@aws-amplify/core/internals/utils';
+import { ConsoleLogger } from '@aws-amplify/core';
 var logger = new ConsoleLogger('KinesisFirehose');
 /**
  * Flushes all buffered Kinesis events to the service.

package/lib-esm/providers/kinesis-firehose/apis/record.js

@@ -3,8 +3,9 @@
 import { getEventBuffer, resolveConfig } from '../utils';
 import { getAnalyticsUserAgentString, isAnalyticsEnabled, resolveCredentials, } from '../../../utils';
 import { fromUtf8 } from '@smithy/util-utf8';
-import { AnalyticsAction, ConsoleLogger as Logger, } from '@aws-amplify/core/internals/utils';
-var logger = new Logger('KinesisFirehose');
+import { AnalyticsAction } from '@aws-amplify/core/internals/utils';
+import { ConsoleLogger } from '@aws-amplify/core';
+var logger = new ConsoleLogger('KinesisFirehose');
 export var record = function (_a) {
     var streamName = _a.streamName, data = _a.data;
     if (!isAnalyticsEnabled()) {

package/lib-esm/providers/personalize/apis/flushEvents.js

@@ -2,7 +2,8 @@
 // SPDX-License-Identifier: Apache-2.0
 import { getEventBuffer, resolveConfig } from '../utils';
 import { getAnalyticsUserAgentString, resolveCredentials, } from '../../../utils';
-import { AnalyticsAction, ConsoleLogger, } from '@aws-amplify/core/internals/utils';
+import { AnalyticsAction } from '@aws-amplify/core/internals/utils';
+import { ConsoleLogger } from '@aws-amplify/core';
 var logger = new ConsoleLogger('Personalize');
 /**
  * Flushes all buffered Personalize events to the service.

package/lib-esm/providers/personalize/apis/record.js

@@ -3,7 +3,8 @@
 import { __awaiter, __generator } from "tslib";
 import { autoTrackMedia, getEventBuffer, resolveCachedSession, resolveConfig, updateCachedSession, } from '../utils';
 import { getAnalyticsUserAgentString, isAnalyticsEnabled, resolveCredentials, } from '../../../utils';
-import { AnalyticsAction, ConsoleLogger, } from '@aws-amplify/core/internals/utils';
+import { AnalyticsAction } from '@aws-amplify/core/internals/utils';
+import { ConsoleLogger } from '@aws-amplify/core';
 import { IDENTIFY_EVENT_TYPE, MEDIA_AUTO_TRACK_EVENT_TYPE, } from '../utils/constants';
 var logger = new ConsoleLogger('Personalize');
 export var record = function (_a) {

package/lib-esm/providers/personalize/utils/autoTrackMedia.js

@@ -1,7 +1,8 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
 import { __assign, __awaiter, __generator, __rest } from "tslib";
-import { ConsoleLogger, isBrowser } from '@aws-amplify/core/internals/utils';
+import { isBrowser } from '@aws-amplify/core/internals/utils';
+import { ConsoleLogger } from '@aws-amplify/core';
 var HTML5_MEDIA_EVENT;
 (function (HTML5_MEDIA_EVENT) {
     HTML5_MEDIA_EVENT["PLAY"] = "play";

package/lib-esm/providers/pinpoint/apis/configureAutoTrack.d.ts

@@ -0,0 +1,15 @@
+import { ConfigureAutoTrackInput } from '../types';
+/**
+ * Configures automatic event tracking for Pinpoint. This API will automatically transmit an analytic event when
+ * configured events are detected within your application. This can include: DOM element events (via the `event`
+ * tracker), session events (via the `session` tracker), and page view events (via the `pageView` tracker).
+ *
+ * @remark Only session tracking is currently supported on React Native.
+ *
+ * @param {ConfigureAutoTrackInput} params The input object to configure auto track behavior.
+ *
+ * @throws service: {@link UpdateEndpointException} - Thrown when the underlying Pinpoint service returns an error.
+ * @throws validation: {@link AnalyticsValidationErrorCode} - Thrown when the provided parameters or library
+ *  configuration is incorrect.
+ */
+export declare const configureAutoTrack: (input: ConfigureAutoTrackInput) => void;

package/lib-esm/providers/pinpoint/apis/configureAutoTrack.js

@@ -0,0 +1,31 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { updateProviderTrackers, validateTrackerConfiguration, } from '../../../utils';
+import { record } from './record';
+// Configured Tracker instances for Pinpoint
+var configuredTrackers = {};
+// Callback that will emit an appropriate event to Pinpoint when required by the Tracker
+var emitTrackingEvent = function (eventName, attributes) {
+    record({
+        name: eventName,
+        attributes: attributes,
+    });
+};
+/**
+ * Configures automatic event tracking for Pinpoint. This API will automatically transmit an analytic event when
+ * configured events are detected within your application. This can include: DOM element events (via the `event`
+ * tracker), session events (via the `session` tracker), and page view events (via the `pageView` tracker).
+ *
+ * @remark Only session tracking is currently supported on React Native.
+ *
+ * @param {ConfigureAutoTrackInput} params The input object to configure auto track behavior.
+ *
+ * @throws service: {@link UpdateEndpointException} - Thrown when the underlying Pinpoint service returns an error.
+ * @throws validation: {@link AnalyticsValidationErrorCode} - Thrown when the provided parameters or library
+ *  configuration is incorrect.
+ */
+export var configureAutoTrack = function (input) {
+    validateTrackerConfiguration(input);
+    // Initialize or update this provider's trackers
+    updateProviderTrackers(input, emitTrackingEvent, configuredTrackers);
+};

package/lib-esm/providers/pinpoint/apis/flushEvents.js

@@ -2,7 +2,8 @@
 // SPDX-License-Identifier: Apache-2.0
 import { resolveConfig, resolveCredentials } from '../utils';
 import { flushEvents as flushEventsCore } from '@aws-amplify/core/internals/providers/pinpoint';
-import { AnalyticsAction, ConsoleLogger, } from '@aws-amplify/core/internals/utils';
+import { AnalyticsAction } from '@aws-amplify/core/internals/utils';
+import { ConsoleLogger } from '@aws-amplify/core';
 import { getAnalyticsUserAgentString } from '../../../utils';
 var logger = new ConsoleLogger('Analytics');
 /**

package/lib-esm/providers/pinpoint/apis/identifyUser.js

@@ -2,7 +2,7 @@
 // SPDX-License-Identifier: Apache-2.0
 import { __awaiter, __generator } from "tslib";
 import { AnalyticsAction } from '@aws-amplify/core/internals/utils';
-import { updateEndpoint } from '@aws-amplify/core/internals/providers/pinpoint';
+import { updateEndpoint, } from '@aws-amplify/core/internals/providers/pinpoint';
 import { getAnalyticsUserAgentString } from '../../../utils';
 import { resolveConfig, resolveCredentials } from '../utils';
 /**
@@ -54,14 +54,13 @@ export var identifyUser = function (_a) {
     var userId = _a.userId, userProfile = _a.userProfile, options = _a.options;
     return __awaiter(void 0, void 0, void 0, function () {
         var _b, credentials, identityId, _c, appId, region, userAttributes;
-        var _d;
-        return __generator(this, function (_e) {
-            switch (_e.label) {
+        return __generator(this, function (_d) {
+            switch (_d.label) {
                 case 0: return [4 /*yield*/, resolveCredentials()];
                 case 1:
-                    _b = _e.sent(), credentials = _b.credentials, identityId = _b.identityId;
+                    _b = _d.sent(), credentials = _b.credentials, identityId = _b.identityId;
                     _c = resolveConfig(), appId = _c.appId, region = _c.region;
-                    userAttributes = ((_d = options === null || options === void 0 ? void 0 : options.serviceOptions) !== null && _d !== void 0 ? _d : {}).userAttributes;
+                    userAttributes = (options !== null && options !== void 0 ? options : {}).userAttributes;
                     updateEndpoint({
                         appId: appId,
                         category: 'Analytics',

package/lib-esm/providers/pinpoint/apis/index.d.ts

@@ -1,3 +1,4 @@
 export { record } from './record';
 export { identifyUser } from './identifyUser';
+export { configureAutoTrack } from './configureAutoTrack';
 export { flushEvents } from './flushEvents';

package/lib-esm/providers/pinpoint/apis/index.js

@@ -2,4 +2,5 @@
 // SPDX-License-Identifier: Apache-2.0
 export { record } from './record';
 export { identifyUser } from './identifyUser';
+export { configureAutoTrack } from './configureAutoTrack';
 export { flushEvents } from './flushEvents';

package/lib-esm/providers/pinpoint/apis/record.js

@@ -1,12 +1,12 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-import { Hub } from '@aws-amplify/core';
-import { AMPLIFY_SYMBOL, AnalyticsAction, ConsoleLogger as Logger, } from '@aws-amplify/core/internals/utils';
+import { Hub, ConsoleLogger } from '@aws-amplify/core';
+import { AMPLIFY_SYMBOL, AnalyticsAction, } from '@aws-amplify/core/internals/utils';
 import { record as recordCore } from '@aws-amplify/core/internals/providers/pinpoint';
 import { AnalyticsValidationErrorCode, assertValidationError, } from '../../../errors';
 import { getAnalyticsUserAgentString, isAnalyticsEnabled, } from '../../../utils';
 import { resolveConfig, resolveCredentials } from '../utils';
-var logger = new Logger('Analytics');
+var logger = new ConsoleLogger('Analytics');
 /**
  * Records an Analytic event to Pinpoint. Events will be buffered and periodically sent to Pinpoint.
  *

package/lib-esm/providers/pinpoint/index.d.ts

@@ -1,2 +1,2 @@
-export { record, identifyUser, flushEvents } from './apis';
-export { RecordInput, IdentifyUserInput } from './types/inputs';
+export { record, identifyUser, flushEvents, configureAutoTrack } from './apis';
+export { RecordInput, IdentifyUserInput, ConfigureAutoTrackInput, } from './types/inputs';

package/lib-esm/providers/pinpoint/index.js

@@ -1,3 +1,3 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-export { record, identifyUser, flushEvents } from './apis';
+export { record, identifyUser, flushEvents, configureAutoTrack } from './apis';

package/lib-esm/providers/pinpoint/types/index.d.ts

@@ -1,3 +1,2 @@
-export { UpdateEndpointException } from './errors';
-export { RecordInput, IdentifyUserInput } from './inputs';
+export { RecordInput, IdentifyUserInput, ConfigureAutoTrackInput, } from './inputs';
 export { IdentifyUserOptions } from './options';

package/lib-esm/providers/pinpoint/types/index.js

@@ -1,3 +1,3 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-export { UpdateEndpointException } from './errors';
+export {};

package/lib-esm/providers/pinpoint/types/inputs.d.ts

@@ -1,6 +1,6 @@
 import { PinpointAnalyticsEvent } from '@aws-amplify/core/internals/providers/pinpoint';
 import { IdentifyUserOptions } from '.';
-import { AnalyticsIdentifyUserInput } from '../../../types';
+import { AnalyticsConfigureAutoTrackInput, AnalyticsIdentifyUserInput } from '../../../types';
 /**
  * Input type for Pinpoint record API.
  */
@@ -9,3 +9,7 @@ export type RecordInput = PinpointAnalyticsEvent;
  * Input type for Pinpoint identifyUser API.
  */
 export type IdentifyUserInput = AnalyticsIdentifyUserInput<IdentifyUserOptions>;
+/**
+ * Input type for Pinpoint configureAutoTrack API.
+ */
+export type ConfigureAutoTrackInput = AnalyticsConfigureAutoTrackInput;

package/lib-esm/trackers/EventTracker.d.ts

@@ -0,0 +1,10 @@
+import { EventTrackingOptions, TrackerEventRecorder, TrackerInterface } from '../types/trackers';
+export declare class EventTracker implements TrackerInterface {
+    private trackerActive;
+    private options;
+    private eventRecorder;
+    constructor(eventRecorder: TrackerEventRecorder, options?: EventTrackingOptions);
+    configure(eventRecorder: TrackerEventRecorder, options?: EventTrackingOptions): void;
+    cleanup(): void;
+    private handleDocEvent;
+}

package/lib-esm/trackers/EventTracker.js

@@ -0,0 +1,101 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { ConsoleLogger } from '@aws-amplify/core';
+import { isBrowser } from '@aws-amplify/core/internals/utils';
+var DEFAULT_EVENTS = ['click'];
+var DEFAULT_SELECTOR_PREFIX = 'data-amplify-analytics-';
+var DEFAULT_EVENT_NAME = 'event'; // Default event name as sent to the analytics provider
+var logger = new ConsoleLogger('EventTracker');
+var EventTracker = /** @class */ (function () {
+    function EventTracker(eventRecorder, options) {
+        this.options = {};
+        this.trackerActive = false;
+        this.eventRecorder = eventRecorder;
+        this.handleDocEvent = this.handleDocEvent.bind(this);
+        this.configure(eventRecorder, options);
+    }
+    EventTracker.prototype.configure = function (eventRecorder, options) {
+        var _this = this;
+        var _a, _b, _c, _d;
+        this.eventRecorder = eventRecorder;
+        // Clean up any existing listeners
+        this.cleanup();
+        // Apply defaults
+        this.options = {
+            attributes: (_a = options === null || options === void 0 ? void 0 : options.attributes) !== null && _a !== void 0 ? _a : undefined,
+            events: (_b = options === null || options === void 0 ? void 0 : options.events) !== null && _b !== void 0 ? _b : DEFAULT_EVENTS,
+            selectorPrefix: (_c = options === null || options === void 0 ? void 0 : options.selectorPrefix) !== null && _c !== void 0 ? _c : DEFAULT_SELECTOR_PREFIX,
+        };
+        // Register event listeners
+        if (isBrowser()) {
+            (_d = this.options.events) === null || _d === void 0 ? void 0 : _d.forEach(function (targetEvent) {
+                document.addEventListener(targetEvent, _this.handleDocEvent, {
+                    capture: true,
+                });
+            });
+            this.trackerActive = true;
+        }
+    };
+    EventTracker.prototype.cleanup = function () {
+        var _this = this;
+        var _a;
+        // No-op if document listener is not active
+        if (!this.trackerActive) {
+            return;
+        }
+        // Clean up event listeners
+        (_a = this.options.events) === null || _a === void 0 ? void 0 : _a.forEach(function (targetEvent) {
+            document.removeEventListener(targetEvent, _this.handleDocEvent, {
+                capture: true,
+            });
+        });
+    };
+    EventTracker.prototype.handleDocEvent = function (event) {
+        var _a;
+        /**
+         * Example DOM element:
+         *
+         * ```
+         * <button
+         *   data-amplify-analytics-on="click"
+         *   data-amplify-analytics-name="click"
+         *   data-amplify-analytics-attrs="attr1:attr1_value,attr2:attr2_value"
+         * />
+         * ```
+         */
+        var triggerSelector = "[".concat(this.options.selectorPrefix, "on]");
+        var attrSelector = "".concat(this.options.selectorPrefix, "attrs");
+        var eventNameSelector = "".concat(this.options.selectorPrefix, "name");
+        var eventSource = event.target;
+        // Validate that the triggering event type is being tracked
+        if (!((_a = this.options.events) === null || _a === void 0 ? void 0 : _a.includes(event.type))) {
+            return;
+        }
+        if (eventSource instanceof HTMLElement) {
+            var target = eventSource.closest(triggerSelector);
+            if (target) {
+                // Parse event name from the element
+                var eventName = target.getAttribute(eventNameSelector) || DEFAULT_EVENT_NAME;
+                // Parse attributes from the element
+                var elementAttributes_1 = {};
+                var rawElementAttributes = target.getAttribute(attrSelector);
+                rawElementAttributes === null || rawElementAttributes === void 0 ? void 0 : rawElementAttributes.split(/\s*,\s*/).forEach(function (attr) {
+                    var tmp = attr.trim().split(/\s*:\s*/);
+                    elementAttributes_1[tmp[0]] = tmp[1];
+                });
+                // Assemble final list of attributes
+                var attributes = Object.assign({
+                    type: event.type,
+                    target: "".concat(target.localName, " with id ").concat(target.id),
+                }, this.options.attributes, elementAttributes_1);
+                logger.debug('Recording automatically tracked DOM event', {
+                    eventName: eventName,
+                    attributes: attributes,
+                });
+                this.eventRecorder(eventName, attributes);
+            }
+        }
+    };
+    return EventTracker;
+}());
+export { EventTracker };

package/lib-esm/trackers/PageViewTracker.d.ts

@@ -0,0 +1,18 @@
+import { PageViewTrackingOptions, TrackerEventRecorder, TrackerInterface } from '../types/trackers';
+export declare class PageViewTracker implements TrackerInterface {
+    private trackerActive;
+    private options;
+    private eventRecorder;
+    private spaTrackingActive;
+    private pushStateProxy?;
+    private replaceStateProxy?;
+    private originalPushState;
+    private originalReplaceState;
+    constructor(eventRecorder: TrackerEventRecorder, options?: PageViewTrackingOptions);
+    configure(eventRecorder: TrackerEventRecorder, options?: PageViewTrackingOptions): void;
+    cleanup(): void;
+    private setupSPATracking;
+    private setupMPATracking;
+    private handleLocationChange;
+    private urlHasChanged;
+}