@aws-amplify/analytics 7.0.1-preview-testing.034e780.0 → 7.0.1-server-generate-client.1e317a1.0

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

@@ -0,0 +1,183 @@
+"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.autoTrackMedia = void 0;
+var tslib_1 = require("tslib");
+var utils_1 = require("@aws-amplify/core/internals/utils");
+var core_1 = require("@aws-amplify/core");
+var HTML5_MEDIA_EVENT;
+(function (HTML5_MEDIA_EVENT) {
+    HTML5_MEDIA_EVENT["PLAY"] = "play";
+    HTML5_MEDIA_EVENT["PAUSE"] = "pause";
+    HTML5_MEDIA_EVENT["ENDED"] = "Ended";
+})(HTML5_MEDIA_EVENT || (HTML5_MEDIA_EVENT = {}));
+var MEDIA_TYPE;
+(function (MEDIA_TYPE) {
+    MEDIA_TYPE["IFRAME"] = "IFRAME";
+    MEDIA_TYPE["VIDEO"] = "VIDEO";
+    MEDIA_TYPE["AUDIO"] = "AUDIO";
+})(MEDIA_TYPE || (MEDIA_TYPE = {}));
+var EVENT_TYPE;
+(function (EVENT_TYPE) {
+    EVENT_TYPE["PLAY"] = "Play";
+    EVENT_TYPE["ENDED"] = "Ended";
+    EVENT_TYPE["PAUSE"] = "Pause";
+    EVENT_TYPE["TIME_WATCHED"] = "TimeWatched";
+})(EVENT_TYPE || (EVENT_TYPE = {}));
+var logger = new core_1.ConsoleLogger('MediaAutoTrack');
+var startIframeAutoTracking = function (element, recordEvent) {
+    var isPlaying = false;
+    var player;
+    var mediaProperties = function () {
+        var duration = Number(parseFloat(player.getDuration()).toFixed(4));
+        var currentTime = Number(parseFloat(player.getCurrentTime()).toFixed(4));
+        return {
+            duration: duration,
+            eventValue: Number((currentTime / duration).toFixed(4)),
+        };
+    };
+    var scriptElement = document.createElement('script');
+    scriptElement.type = 'text/javascript';
+    scriptElement.src = 'https://www.youtube.com/iframe_api';
+    document.body.append(scriptElement);
+    var timer = setInterval(function () {
+        if (isPlaying && player) {
+            recordEvent(EVENT_TYPE.TIME_WATCHED, mediaProperties());
+        }
+    }, 3000);
+    element.addEventListener('unload', function () { return clearInterval(timer); });
+    // @ts-ignore
+    window.onYouTubeIframeAPIReady = function () {
+        // @ts-ignore
+        delete window.onYouTubeIframeAPIReady;
+        // @ts-ignore
+        player = new window.YT.Player(element.id, {
+            events: {
+                onStateChange: function (event) {
+                    var iframeEventMapping = {
+                        0: EVENT_TYPE.ENDED,
+                        1: EVENT_TYPE.PLAY,
+                        2: EVENT_TYPE.PAUSE,
+                    };
+                    // @ts-ignore
+                    var eventType = iframeEventMapping[event.data];
+                    switch (eventType) {
+                        case EVENT_TYPE.ENDED:
+                        case EVENT_TYPE.PAUSE:
+                            isPlaying = false;
+                            break;
+                        case EVENT_TYPE.PLAY:
+                            isPlaying = true;
+                            break;
+                    }
+                    if (eventType) {
+                        recordEvent(eventType, mediaProperties());
+                    }
+                },
+            },
+        });
+    };
+};
+var startHTMLMediaAutoTracking = function (element, recordEvent) {
+    var isPlaying = false;
+    var mediaProperties = function () { return ({
+        duration: element.duration,
+        eventValue: Number((element.currentTime / element.duration).toFixed(4)),
+    }); };
+    var timer = setInterval(function () {
+        if (isPlaying) {
+            recordEvent(EVENT_TYPE.TIME_WATCHED, mediaProperties());
+        }
+    }, 3000);
+    element.addEventListener('unload', function () { return clearInterval(timer); });
+    element.addEventListener(HTML5_MEDIA_EVENT.PLAY, function () {
+        isPlaying = true;
+        recordEvent(EVENT_TYPE.PLAY, mediaProperties());
+    });
+    element.addEventListener(HTML5_MEDIA_EVENT.PAUSE, function () {
+        isPlaying = false;
+        recordEvent(EVENT_TYPE.PAUSE, mediaProperties());
+    });
+    element.addEventListener(HTML5_MEDIA_EVENT.ENDED, function () {
+        isPlaying = false;
+        recordEvent(EVENT_TYPE.ENDED, mediaProperties());
+    });
+};
+var checkElementLoaded = function (interval, maxTries) {
+    var retryCount = 0;
+    var wait = function () { return new Promise(function (r) { return setTimeout(r, interval); }); };
+    var check = function (elementId) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+        var domElement;
+        return tslib_1.__generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (retryCount >= maxTries) {
+                        return [2 /*return*/, false];
+                    }
+                    domElement = document.getElementById(elementId);
+                    if (!(domElement && domElement.clientHeight)) return [3 /*break*/, 1];
+                    return [2 /*return*/, true];
+                case 1:
+                    retryCount += 1;
+                    return [4 /*yield*/, wait()];
+                case 2:
+                    _a.sent();
+                    return [4 /*yield*/, check(elementId)];
+                case 3: return [2 /*return*/, _a.sent()];
+            }
+        });
+    }); };
+    return check;
+};
+var recordEvent = function (config, eventBuffer) {
+    return function (eventType, properties) {
+        // override eventType and merge properties
+        eventBuffer.append(tslib_1.__assign(tslib_1.__assign({}, config), { event: tslib_1.__assign(tslib_1.__assign({}, config.event), { eventType: eventType, properties: tslib_1.__assign(tslib_1.__assign({}, config.event.properties), properties) }), timestamp: Date.now() }));
+    };
+};
+var autoTrackMedia = function (config, eventBuffer) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+    var _a, eventType, properties, domElementId, otherProperties, elementId, isElementLoaded, autoTrackConfigWithoutDomElementId, element;
+    return tslib_1.__generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                _a = config.event, eventType = _a.eventType, properties = _a.properties;
+                domElementId = properties.domElementId, otherProperties = tslib_1.__rest(properties, ["domElementId"]);
+                if (!(0, utils_1.isBrowser)()) {
+                    logger.debug("".concat(eventType, " only for browser"));
+                    return [2 /*return*/];
+                }
+                if (typeof domElementId === 'string' && !domElementId) {
+                    logger.debug("Missing domElementId field in 'properties' for MediaAutoTrack event type.");
+                    return [2 /*return*/];
+                }
+                elementId = domElementId;
+                return [4 /*yield*/, checkElementLoaded(500, 5)(elementId)];
+            case 1:
+                isElementLoaded = _b.sent();
+                if (isElementLoaded) {
+                    autoTrackConfigWithoutDomElementId = tslib_1.__assign(tslib_1.__assign({}, config), { event: tslib_1.__assign(tslib_1.__assign({}, config.event), { properties: otherProperties }) });
+                    element = document.getElementById(elementId);
+                    switch (element === null || element === void 0 ? void 0 : element.tagName) {
+                        case MEDIA_TYPE.IFRAME:
+                            startIframeAutoTracking(element, recordEvent(autoTrackConfigWithoutDomElementId, eventBuffer));
+                            break;
+                        case MEDIA_TYPE.VIDEO:
+                        case MEDIA_TYPE.AUDIO:
+                            if (element instanceof HTMLMediaElement) {
+                                startHTMLMediaAutoTracking(element, recordEvent(autoTrackConfigWithoutDomElementId, eventBuffer));
+                            }
+                            break;
+                        default:
+                            logger.debug("Unsupported DOM element tag: ".concat(element === null || element === void 0 ? void 0 : element.tagName));
+                            break;
+                    }
+                }
+                else {
+                    logger.debug('Cannot find the media element.');
+                }
+                return [2 /*return*/];
+        }
+    });
+}); };
+exports.autoTrackMedia = autoTrackMedia;

package/lib/providers/personalize/utils/cachedSession.d.ts

@@ -0,0 +1,5 @@
+export declare const resolveCachedSession: () => Promise<{
+    sessionId: string;
+    userId: string | undefined;
+}>;
+export declare const updateCachedSession: (newUserId?: string, currentSessionId?: string, currentUserId?: string) => void;

package/lib/providers/personalize/utils/cachedSession.js

@@ -0,0 +1,61 @@
+"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.updateCachedSession = exports.resolveCachedSession = void 0;
+var tslib_1 = require("tslib");
+var core_1 = require("@aws-amplify/core");
+var utils_1 = require("@aws-amplify/core/internals/utils");
+var PERSONALIZE_CACHE_USERID = '_awsct_uid';
+var PERSONALIZE_CACHE_SESSIONID = '_awsct_sid';
+var DEFAULT_CACHE_PREFIX = 'personalize';
+var DELIMITER = '.';
+var CACHE_EXPIRY_IN_DAYS = 7;
+var normalize = function (key) {
+    return [key, (0, utils_1.isBrowser)() ? window.location.host : DEFAULT_CACHE_PREFIX].join(DELIMITER);
+};
+var getCache = function (key) { return core_1.Cache.getItem(normalize(key)); };
+var setCache = function (key, value) {
+    var expiredAt = new Date(Date.now() + 3600000 * 24 * CACHE_EXPIRY_IN_DAYS);
+    core_1.Cache.setItem(normalize(key), value, {
+        expires: expiredAt.getTime(),
+    });
+};
+var resolveCachedSession = function () { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+    var sessionId, userId;
+    return tslib_1.__generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, getCache(PERSONALIZE_CACHE_SESSIONID)];
+            case 1:
+                sessionId = _a.sent();
+                if (!sessionId) {
+                    sessionId = (0, utils_1.amplifyUuid)();
+                    setCache(PERSONALIZE_CACHE_SESSIONID, sessionId);
+                }
+                return [4 /*yield*/, getCache(PERSONALIZE_CACHE_USERID)];
+            case 2:
+                userId = _a.sent();
+                return [2 /*return*/, {
+                        sessionId: sessionId,
+                        userId: userId,
+                    }];
+        }
+    });
+}); };
+exports.resolveCachedSession = resolveCachedSession;
+var updateCachedSession = function (newUserId, currentSessionId, currentUserId) {
+    var isNoCachedSession = !currentSessionId;
+    var isSignOutCase = !newUserId && !currentUserId;
+    var isSwitchUserCase = !!newUserId && !!currentUserId && newUserId !== currentUserId;
+    var isRequireNewSession = isNoCachedSession || isSignOutCase || isSwitchUserCase;
+    var isRequireUpdateSession = !!currentSessionId && !currentUserId && !!newUserId;
+    if (isRequireNewSession) {
+        var newSessionId = (0, utils_1.amplifyUuid)();
+        setCache(PERSONALIZE_CACHE_SESSIONID, newSessionId);
+        setCache(PERSONALIZE_CACHE_USERID, newUserId);
+    }
+    else if (isRequireUpdateSession) {
+        setCache(PERSONALIZE_CACHE_USERID, newUserId);
+    }
+};
+exports.updateCachedSession = updateCachedSession;

package/lib/providers/personalize/utils/constants.d.ts

@@ -0,0 +1,7 @@
+export declare const DEFAULT_PERSONALIZE_CONFIG: {
+    flushSize: number;
+    flushInterval: number;
+};
+export declare const PERSONALIZE_FLUSH_SIZE_MAX = 10;
+export declare const IDENTIFY_EVENT_TYPE = "Identify";
+export declare const MEDIA_AUTO_TRACK_EVENT_TYPE = "MediaAutoTrack";

package/lib/providers/personalize/utils/constants.js

@@ -0,0 +1,12 @@
+"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.MEDIA_AUTO_TRACK_EVENT_TYPE = exports.IDENTIFY_EVENT_TYPE = exports.PERSONALIZE_FLUSH_SIZE_MAX = exports.DEFAULT_PERSONALIZE_CONFIG = void 0;
+exports.DEFAULT_PERSONALIZE_CONFIG = {
+    flushSize: 5,
+    flushInterval: 5000,
+};
+exports.PERSONALIZE_FLUSH_SIZE_MAX = 10;
+exports.IDENTIFY_EVENT_TYPE = 'Identify';
+exports.MEDIA_AUTO_TRACK_EVENT_TYPE = 'MediaAutoTrack';

package/lib/providers/personalize/utils/getEventBuffer.d.ts

@@ -0,0 +1,3 @@
+import { EventBuffer } from '../../../utils';
+import { PersonalizeBufferConfig, PersonalizeBufferEvent } from '../types';
+export declare const getEventBuffer: ({ region, flushSize, flushInterval, bufferSize, credentials, identityId, userAgentValue, }: PersonalizeBufferConfig) => EventBuffer<PersonalizeBufferEvent>;

package/lib/providers/personalize/utils/getEventBuffer.js

@@ -0,0 +1,100 @@
+"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.getEventBuffer = void 0;
+var tslib_1 = require("tslib");
+var utils_1 = require("../../../utils");
+var client_personalize_events_1 = require("@aws-sdk/client-personalize-events");
+/**
+ * These Records hold cached event buffers and AWS clients.
+ * The hash key is determined by the region and session,
+ * consisting of a combined value comprising [region, sessionToken, identityId].
+ *
+ * Only one active session should exist at any given moment.
+ * When a new session is initiated, the previous ones should be released.
+ * */
+var eventBufferMap = {};
+var cachedClients = {};
+var DELIMITER = '#';
+var createPutEventsCommand = function (ids, events) {
+    var _a = tslib_1.__read(ids.split(DELIMITER), 3), trackingId = _a[0], sessionId = _a[1], userId = _a[2];
+    return new client_personalize_events_1.PutEventsCommand({
+        trackingId: trackingId,
+        sessionId: sessionId,
+        userId: userId,
+        eventList: events.map(function (event) { return ({
+            eventId: event.event.eventId,
+            eventType: event.event.eventType,
+            properties: JSON.stringify(event.event.properties),
+            sentAt: new Date(event.timestamp),
+        }); }),
+    });
+};
+var submitEvents = function (events, client) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+    var groupedByIds, requests;
+    return tslib_1.__generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                groupedByIds = Object.entries((0, utils_1.groupBy)(function (event) {
+                    return [event.trackingId, event.sessionId, event.userId]
+                        .filter(function (id) { return !!id; })
+                        .join(DELIMITER);
+                }, events));
+                requests = groupedByIds
+                    .map(function (_a) {
+                    var _b = tslib_1.__read(_a, 2), ids = _b[0], events = _b[1];
+                    return createPutEventsCommand(ids, events);
+                })
+                    .map(function (command) { return client.send(command); });
+                return [4 /*yield*/, Promise.allSettled(requests)];
+            case 1:
+                _a.sent();
+                return [2 /*return*/, Promise.resolve([])];
+        }
+    });
+}); };
+var getEventBuffer = function (_a) {
+    var e_1, _b;
+    var region = _a.region, flushSize = _a.flushSize, flushInterval = _a.flushInterval, bufferSize = _a.bufferSize, credentials = _a.credentials, identityId = _a.identityId, userAgentValue = _a.userAgentValue;
+    var sessionToken = credentials.sessionToken;
+    var sessionIdentityKey = [region, sessionToken, identityId]
+        .filter(function (x) { return !!x; })
+        .join('-');
+    if (!eventBufferMap[sessionIdentityKey]) {
+        var getClient = function () {
+            if (!cachedClients[sessionIdentityKey]) {
+                cachedClients[sessionIdentityKey] = new client_personalize_events_1.PersonalizeEventsClient({
+                    region: region,
+                    credentials: credentials,
+                    customUserAgent: userAgentValue,
+                });
+            }
+            return function (events) { return submitEvents(events, cachedClients[sessionIdentityKey]); };
+        };
+        eventBufferMap[sessionIdentityKey] =
+            new utils_1.EventBuffer({
+                bufferSize: bufferSize,
+                flushSize: flushSize,
+                flushInterval: flushInterval,
+            }, getClient);
+        var releaseSessionKeys = Object.keys(eventBufferMap).filter(function (key) { return key !== sessionIdentityKey; });
+        try {
+            for (var releaseSessionKeys_1 = tslib_1.__values(releaseSessionKeys), releaseSessionKeys_1_1 = releaseSessionKeys_1.next(); !releaseSessionKeys_1_1.done; releaseSessionKeys_1_1 = releaseSessionKeys_1.next()) {
+                var releaseSessionKey = releaseSessionKeys_1_1.value;
+                eventBufferMap[releaseSessionKey].release();
+                delete eventBufferMap[releaseSessionKey];
+                delete cachedClients[releaseSessionKey];
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (releaseSessionKeys_1_1 && !releaseSessionKeys_1_1.done && (_b = releaseSessionKeys_1.return)) _b.call(releaseSessionKeys_1);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+    }
+    return eventBufferMap[sessionIdentityKey];
+};
+exports.getEventBuffer = getEventBuffer;

package/lib/providers/personalize/utils/index.d.ts

@@ -0,0 +1,5 @@
+export { getEventBuffer } from './getEventBuffer';
+export { resolveConfig } from './resolveConfig';
+export { autoTrackMedia } from './autoTrackMedia';
+export { resolveCachedSession, updateCachedSession } from './cachedSession';
+export { DEFAULT_PERSONALIZE_CONFIG, PERSONALIZE_FLUSH_SIZE_MAX, } from './constants';

package/lib/providers/personalize/utils/index.js

@@ -0,0 +1,17 @@
+"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.PERSONALIZE_FLUSH_SIZE_MAX = exports.DEFAULT_PERSONALIZE_CONFIG = exports.updateCachedSession = exports.resolveCachedSession = exports.autoTrackMedia = exports.resolveConfig = exports.getEventBuffer = void 0;
+var getEventBuffer_1 = require("./getEventBuffer");
+Object.defineProperty(exports, "getEventBuffer", { enumerable: true, get: function () { return getEventBuffer_1.getEventBuffer; } });
+var resolveConfig_1 = require("./resolveConfig");
+Object.defineProperty(exports, "resolveConfig", { enumerable: true, get: function () { return resolveConfig_1.resolveConfig; } });
+var autoTrackMedia_1 = require("./autoTrackMedia");
+Object.defineProperty(exports, "autoTrackMedia", { enumerable: true, get: function () { return autoTrackMedia_1.autoTrackMedia; } });
+var cachedSession_1 = require("./cachedSession");
+Object.defineProperty(exports, "resolveCachedSession", { enumerable: true, get: function () { return cachedSession_1.resolveCachedSession; } });
+Object.defineProperty(exports, "updateCachedSession", { enumerable: true, get: function () { return cachedSession_1.updateCachedSession; } });
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "DEFAULT_PERSONALIZE_CONFIG", { enumerable: true, get: function () { return constants_1.DEFAULT_PERSONALIZE_CONFIG; } });
+Object.defineProperty(exports, "PERSONALIZE_FLUSH_SIZE_MAX", { enumerable: true, get: function () { return constants_1.PERSONALIZE_FLUSH_SIZE_MAX; } });

package/lib/providers/personalize/utils/resolveConfig.d.ts

@@ -0,0 +1,7 @@
+export declare const resolveConfig: () => {
+    region: string;
+    trackingId: string;
+    bufferSize: number;
+    flushSize: number;
+    flushInterval: number;
+};

package/lib/providers/personalize/utils/resolveConfig.js

@@ -0,0 +1,25 @@
+"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.resolveConfig = void 0;
+var tslib_1 = require("tslib");
+var core_1 = require("@aws-amplify/core");
+var errors_1 = require("../../../errors");
+var _1 = require("./");
+var resolveConfig = function () {
+    var _a;
+    var config = (_a = core_1.Amplify.getConfig().Analytics) === null || _a === void 0 ? void 0 : _a.Personalize;
+    var _b = tslib_1.__assign(tslib_1.__assign({}, _1.DEFAULT_PERSONALIZE_CONFIG), config), region = _b.region, trackingId = _b.trackingId, _c = _b.flushSize, flushSize = _c === void 0 ? _1.DEFAULT_PERSONALIZE_CONFIG.flushSize : _c, _d = _b.flushInterval, flushInterval = _d === void 0 ? _1.DEFAULT_PERSONALIZE_CONFIG.flushInterval : _d;
+    (0, errors_1.assertValidationError)(!!region, errors_1.AnalyticsValidationErrorCode.NoRegion);
+    (0, errors_1.assertValidationError)(!!trackingId, errors_1.AnalyticsValidationErrorCode.NoTrackingId);
+    (0, errors_1.assertValidationError)(flushSize <= _1.PERSONALIZE_FLUSH_SIZE_MAX, errors_1.AnalyticsValidationErrorCode.InvalidFlushSize, "FlushSize for Personalize should be less or equal than ".concat(_1.PERSONALIZE_FLUSH_SIZE_MAX));
+    return {
+        region: region,
+        trackingId: trackingId,
+        bufferSize: flushSize + 1,
+        flushSize: flushSize,
+        flushInterval: flushInterval,
+    };
+};
+exports.resolveConfig = resolveConfig;

package/lib/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/providers/pinpoint/apis/configureAutoTrack.js

@@ -0,0 +1,35 @@
+"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.configureAutoTrack = void 0;
+var utils_1 = require("../../../utils");
+var record_1 = require("./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) {
+    (0, record_1.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.
+ */
+var configureAutoTrack = function (input) {
+    (0, utils_1.validateTrackerConfiguration)(input);
+    // Initialize or update this provider's trackers
+    (0, utils_1.updateProviderTrackers)(input, emitTrackingEvent, configuredTrackers);
+};
+exports.configureAutoTrack = configureAutoTrack;

package/lib/providers/pinpoint/apis/flushEvents.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Flushes all buffered Pinpoint events to the service.
+ *
+ * @note
+ * This API will make a best-effort attempt to flush events from the buffer. Events recorded immediately after invoking
+ * this API may not be included in the flush.
+ */
+export declare const flushEvents: () => void;

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

@@ -0,0 +1,28 @@
+"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.flushEvents = void 0;
+var utils_1 = require("../utils");
+var pinpoint_1 = require("@aws-amplify/core/internals/providers/pinpoint");
+var utils_2 = require("@aws-amplify/core/internals/utils");
+var core_1 = require("@aws-amplify/core");
+var utils_3 = require("../../../utils");
+var logger = new core_1.ConsoleLogger('Analytics');
+/**
+ * Flushes all buffered Pinpoint events to the service.
+ *
+ * @note
+ * This API will make a best-effort attempt to flush events from the buffer. Events recorded immediately after invoking
+ * this API may not be included in the flush.
+ */
+var flushEvents = function () {
+    var _a = (0, utils_1.resolveConfig)(), appId = _a.appId, region = _a.region;
+    (0, utils_1.resolveCredentials)()
+        .then(function (_a) {
+        var credentials = _a.credentials, identityId = _a.identityId;
+        return (0, pinpoint_1.flushEvents)(appId, region, credentials, identityId, (0, utils_3.getAnalyticsUserAgentString)(utils_2.AnalyticsAction.Record));
+    })
+        .catch(function (e) { return logger.warn('Failed to flush events', e); });
+};
+exports.flushEvents = flushEvents;

package/lib/providers/pinpoint/apis/identifyUser.d.ts

@@ -19,8 +19,9 @@ import { IdentifyUserInput } from '../types';
  * await identifyUser({
  *     userId,
  *     userProfile: {
- *         attributes: {
- *             email: [userEmail],
+ *         email: 'userEmail@example.com'
+ *         customProperties: {
+ *             phoneNumber: ['555-555-5555'],
  *         },
  *     }
  * });
@@ -32,8 +33,9 @@ import { IdentifyUserInput } from '../types';
  * await identifyUser({
  *     userId,
  *     userProfile: {
- *         attributes: {
- *             email: [userEmail],
+ *         email: 'userEmail@example.com'
+ *         customProperties: {
+ *             phoneNumber: ['555-555-5555'],
  *         },
  *         demographic: {
  *             platform: 'ios',
@@ -42,4 +44,4 @@ import { IdentifyUserInput } from '../types';
  *     }
  * });
  */
-export declare const identifyUser: ({ userId, userProfile, }: IdentifyUserInput) => Promise<void>;
+export declare const identifyUser: ({ userId, userProfile, options, }: IdentifyUserInput) => Promise<void>;

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

@@ -6,8 +6,8 @@ exports.identifyUser = void 0;
 var tslib_1 = require("tslib");
 var utils_1 = require("@aws-amplify/core/internals/utils");
 var pinpoint_1 = require("@aws-amplify/core/internals/providers/pinpoint");
-var userAgent_1 = require("../../../utils/userAgent");
-var utils_2 = require("../utils");
+var utils_2 = require("../../../utils");
+var utils_3 = require("../utils");
 /**
  * Sends information about a user to Pinpoint. Sending user information allows you to associate a user to their user
  * profile and activities or actions in your application. Activity can be tracked across devices & platforms by using
@@ -28,8 +28,9 @@ var utils_2 = require("../utils");
  * await identifyUser({
  *     userId,
  *     userProfile: {
- *         attributes: {
- *             email: [userEmail],
+ *         email: 'userEmail@example.com'
+ *         customProperties: {
+ *             phoneNumber: ['555-555-5555'],
  *         },
  *     }
  * });
@@ -41,8 +42,9 @@ var utils_2 = require("../utils");
  * await identifyUser({
  *     userId,
  *     userProfile: {
- *         attributes: {
- *             email: [userEmail],
+ *         email: 'userEmail@example.com'
+ *         customProperties: {
+ *             phoneNumber: ['555-555-5555'],
  *         },
  *         demographic: {
  *             platform: 'ios',
@@ -52,24 +54,26 @@ var utils_2 = require("../utils");
  * });
  */
 var identifyUser = function (_a) {
-    var userId = _a.userId, userProfile = _a.userProfile;
+    var userId = _a.userId, userProfile = _a.userProfile, options = _a.options;
     return tslib_1.__awaiter(void 0, void 0, void 0, function () {
-        var _b, credentials, identityId, _c, appId, region;
+        var _b, credentials, identityId, _c, appId, region, userAttributes;
         return tslib_1.__generator(this, function (_d) {
             switch (_d.label) {
-                case 0: return [4 /*yield*/, (0, utils_2.resolveCredentials)()];
+                case 0: return [4 /*yield*/, (0, utils_3.resolveCredentials)()];
                 case 1:
                     _b = _d.sent(), credentials = _b.credentials, identityId = _b.identityId;
-                    _c = (0, utils_2.resolveConfig)(), appId = _c.appId, region = _c.region;
+                    _c = (0, utils_3.resolveConfig)(), appId = _c.appId, region = _c.region;
+                    userAttributes = (options !== null && options !== void 0 ? options : {}).userAttributes;
                     (0, pinpoint_1.updateEndpoint)({
                         appId: appId,
                         category: 'Analytics',
                         credentials: credentials,
                         identityId: identityId,
                         region: region,
+                        userAttributes: userAttributes,
                         userId: userId,
                         userProfile: userProfile,
-                        userAgentValue: (0, userAgent_1.getAnalyticsUserAgentString)(utils_1.AnalyticsAction.UpdateEndpoint),
+                        userAgentValue: (0, utils_2.getAnalyticsUserAgentString)(utils_1.AnalyticsAction.IdentifyUser),
                     });
                     return [2 /*return*/];
             }

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

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

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

@@ -2,8 +2,12 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.identifyUser = exports.record = void 0;
+exports.flushEvents = exports.configureAutoTrack = exports.identifyUser = exports.record = void 0;
 var record_1 = require("./record");
 Object.defineProperty(exports, "record", { enumerable: true, get: function () { return record_1.record; } });
 var identifyUser_1 = require("./identifyUser");
 Object.defineProperty(exports, "identifyUser", { enumerable: true, get: function () { return identifyUser_1.identifyUser; } });
+var configureAutoTrack_1 = require("./configureAutoTrack");
+Object.defineProperty(exports, "configureAutoTrack", { enumerable: true, get: function () { return configureAutoTrack_1.configureAutoTrack; } });
+var flushEvents_1 = require("./flushEvents");
+Object.defineProperty(exports, "flushEvents", { enumerable: true, get: function () { return flushEvents_1.flushEvents; } });