@aws-amplify/analytics 7.0.1-preview-testing.be90020.0 → 7.0.1-ssr-api.df60e41.0

package/lib/types/kinesis.js

@@ -0,0 +1,4 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types/options.d.ts

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

package/lib/types/options.js

@@ -0,0 +1,4 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });

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/types/trackers.js

@@ -0,0 +1,4 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/utils/eventBuffer/EventBuffer.d.ts

@@ -0,0 +1,16 @@
+import { EventBufferConfig, IAnalyticsClient } from './';
+export declare class EventBuffer<T> {
+    private list;
+    private readonly config;
+    private getAnalyticsClient;
+    private timer?;
+    constructor(config: EventBufferConfig, getAnalyticsClient: () => IAnalyticsClient<T>);
+    append(...events: T[]): void;
+    flushAll(): Promise<void>;
+    release(): void;
+    get length(): number;
+    private head;
+    private insertAtBeginning;
+    private startEventLoop;
+    private submitEvents;
+}

package/lib/utils/eventBuffer/EventBuffer.js

@@ -0,0 +1,63 @@
+"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.EventBuffer = void 0;
+const core_1 = require("@aws-amplify/core");
+const logger = new core_1.ConsoleLogger('EventBuffer');
+class EventBuffer {
+    constructor(config, getAnalyticsClient) {
+        this.list = [];
+        this.config = config;
+        this.getAnalyticsClient = getAnalyticsClient;
+        this.startEventLoop();
+    }
+    append(...events) {
+        for (const event of events) {
+            if (this.list.length + 1 > this.config.bufferSize) {
+                logger.debug(`Exceed ${typeof event} event buffer limits, event dropped`);
+                continue;
+            }
+            this.list.push(event);
+        }
+    }
+    flushAll() {
+        return this.submitEvents(this.list.length);
+    }
+    release() {
+        this.list = [];
+        if (this.timer) {
+            clearInterval(this.timer);
+        }
+    }
+    get length() {
+        return this.list.length;
+    }
+    head(count) {
+        return this.list.splice(0, count);
+    }
+    insertAtBeginning(...data) {
+        this.list.unshift(...data);
+    }
+    startEventLoop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+        }
+        const { flushSize, flushInterval } = this.config;
+        setInterval(() => {
+            this.submitEvents(flushSize);
+        }, flushInterval);
+    }
+    submitEvents(count) {
+        const events = this.head(count);
+        if (events.length === 0) {
+            return Promise.resolve();
+        }
+        return this.getAnalyticsClient()(events).then(result => {
+            if (result.length > 0) {
+                this.insertAtBeginning(...result);
+            }
+        });
+    }
+}
+exports.EventBuffer = EventBuffer;

package/lib/utils/eventBuffer/index.d.ts

@@ -0,0 +1,2 @@
+export { EventBuffer } from './EventBuffer';
+export { EventBufferConfig, IAnalyticsClient } from './types';

package/lib/utils/eventBuffer/index.js

@@ -0,0 +1,7 @@
+"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.EventBuffer = void 0;
+var EventBuffer_1 = require("./EventBuffer");
+Object.defineProperty(exports, "EventBuffer", { enumerable: true, get: function () { return EventBuffer_1.EventBuffer; } });

package/lib/utils/eventBuffer/types.d.ts

@@ -0,0 +1,8 @@
+export interface IAnalyticsClient<T> {
+    (events: T[]): Promise<T[]>;
+}
+export type EventBufferConfig = {
+    flushSize: number;
+    flushInterval: number;
+    bufferSize: number;
+};

package/lib/utils/eventBuffer/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/utils/groupBy.d.ts

@@ -0,0 +1 @@
+export declare const groupBy: <T>(getGroupId: (x: T) => string, list: T[]) => Record<string, T[]>;

package/lib/utils/groupBy.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.groupBy = void 0;
+const groupBy = (getGroupId, list) => {
+    return list.reduce((result, current) => {
+        const groupId = getGroupId(current);
+        return { ...result, [groupId]: [...(result[groupId] ?? []), current] };
+    }, {});
+};
+exports.groupBy = groupBy;

package/lib/utils/index.d.ts

@@ -0,0 +1,7 @@
+export { resolveCredentials } from './resolveCredentials';
+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

@@ -0,0 +1,22 @@
+"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 = 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");
+Object.defineProperty(exports, "groupBy", { enumerable: true, get: function () { return groupBy_1.groupBy; } });
+var eventBuffer_1 = require("./eventBuffer");
+Object.defineProperty(exports, "EventBuffer", { enumerable: true, get: function () { return eventBuffer_1.EventBuffer; } });
+var statusHelpers_1 = require("./statusHelpers");
+Object.defineProperty(exports, "enableAnalytics", { enumerable: true, get: function () { return statusHelpers_1.enableAnalytics; } });
+Object.defineProperty(exports, "disableAnalytics", { enumerable: true, get: function () { return statusHelpers_1.disableAnalytics; } });
+Object.defineProperty(exports, "isAnalyticsEnabled", { enumerable: true, get: function () { return statusHelpers_1.isAnalyticsEnabled; } });
+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/resolveCredentials.d.ts

@@ -0,0 +1,4 @@
+export declare const resolveCredentials: () => Promise<{
+    credentials: import("@aws-amplify/core/lib-esm/libraryUtils").AWSCredentials;
+    identityId: string | undefined;
+}>;

package/lib/utils/resolveCredentials.js

@@ -0,0 +1,13 @@
+"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.resolveCredentials = void 0;
+const errors_1 = require("../errors");
+const core_1 = require("@aws-amplify/core");
+const resolveCredentials = async () => {
+    const { credentials, identityId } = await (0, core_1.fetchAuthSession)();
+    (0, errors_1.assertValidationError)(!!credentials, errors_1.AnalyticsValidationErrorCode.NoCredentials);
+    return { credentials, identityId };
+};
+exports.resolveCredentials = resolveCredentials;

package/lib/utils/statusHelpers.d.ts

@@ -0,0 +1,6 @@
+export declare const enableAnalytics: () => void;
+export declare const disableAnalytics: () => void;
+/**
+ * Returns the current status of the Analytics category.
+ */
+export declare const isAnalyticsEnabled: () => boolean;

package/lib/utils/statusHelpers.js

@@ -0,0 +1,19 @@
+"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.isAnalyticsEnabled = exports.disableAnalytics = exports.enableAnalytics = void 0;
+let analyticsEnabled = true;
+const enableAnalytics = () => {
+    analyticsEnabled = true;
+};
+exports.enableAnalytics = enableAnalytics;
+const disableAnalytics = () => {
+    analyticsEnabled = false;
+};
+exports.disableAnalytics = disableAnalytics;
+/**
+ * Returns the current status of the Analytics category.
+ */
+const isAnalyticsEnabled = () => analyticsEnabled;
+exports.isAnalyticsEnabled = isAnalyticsEnabled;

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;
+const errors_1 = require("../errors");
+/**
+ * Validates tracker configuration.
+ */
+const validateTrackerConfiguration = (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;
+const errors_1 = require("../errors");
+/**
+ * Validates tracker configuration.
+ */
+const validateTrackerConfiguration = (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;
+const 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`.
+ */
+const updateProviderTrackers = (input, providerEventRecorder, providerTrackers) => {
+    let trackerInstance;
+    const trackerType = input.type;
+    const 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/utils/userAgent.js

@@ -3,18 +3,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAnalyticsUserAgentString = exports.getAnalyticsUserAgent = void 0;
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-var utils_1 = require("@aws-amplify/core/internals/utils");
+const utils_1 = require("@aws-amplify/core/internals/utils");
 function getAnalyticsUserAgent(action) {
     return (0, utils_1.getAmplifyUserAgentObject)({
         category: utils_1.Category.Analytics,
-        action: action,
+        action,
     });
 }
 exports.getAnalyticsUserAgent = getAnalyticsUserAgent;
 function getAnalyticsUserAgentString(action) {
     return (0, utils_1.getAmplifyUserAgent)({
         category: utils_1.Category.Analytics,
-        action: action,
+        action,
     });
 }
 exports.getAnalyticsUserAgentString = getAnalyticsUserAgentString;

package/lib-esm/apis/disable.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Disables the Analytics category.
+ *
+ * @note
+ * When Analytics is disabled events will not be buffered or transmitted to your selected service. Any auto-tracking
+ * behavior that you have configured via `configureAutoTrack` will not have any effect while Analytics is disabled.
+ */
+export declare const disable: () => void;

package/lib-esm/apis/disable.js

@@ -0,0 +1,11 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { disableAnalytics } from '../utils';
+/**
+ * Disables the Analytics category.
+ *
+ * @note
+ * When Analytics is disabled events will not be buffered or transmitted to your selected service. Any auto-tracking
+ * behavior that you have configured via `configureAutoTrack` will not have any effect while Analytics is disabled.
+ */
+export const disable = disableAnalytics;

package/lib-esm/apis/enable.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Enables the Analytics category to permit the transmission of events.
+ *
+ * @note
+ * Analytics is enabled by default. You do not need to call this API unless you have disabled Analytics.
+ */
+export declare const enable: () => void;

package/lib-esm/apis/enable.js

@@ -0,0 +1,10 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { enableAnalytics } from '../utils';
+/**
+ * Enables the Analytics category to permit the transmission of events.
+ *
+ * @note
+ * Analytics is enabled by default. You do not need to call this API unless you have disabled Analytics.
+ */
+export const enable = enableAnalytics;

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

@@ -0,0 +1,2 @@
+export { enable } from './enable';
+export { disable } from './disable';

package/lib-esm/apis/index.js

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

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

@@ -1,7 +1,7 @@
-import { AmplifyError, ErrorParams } from '@aws-amplify/core/internals/utils';
+import { AmplifyError, AmplifyErrorParams } from '@aws-amplify/core/internals/utils';
 /**
  * @internal
  */
 export declare class AnalyticsError extends AmplifyError {
-    constructor(params: ErrorParams);
+    constructor(params: AmplifyErrorParams);
 }

package/lib-esm/errors/AnalyticsError.js

@@ -1,20 +1,15 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-import { __extends } from "tslib";
-import { AmplifyError } from '@aws-amplify/core/internals/utils';
+import { AmplifyError, } from '@aws-amplify/core/internals/utils';
 /**
  * @internal
  */
-var AnalyticsError = /** @class */ (function (_super) {
-    __extends(AnalyticsError, _super);
-    function AnalyticsError(params) {
-        var _this = _super.call(this, params) || this;
+export class AnalyticsError extends AmplifyError {
+    constructor(params) {
+        super(params);
         // Hack for making the custom error class work when transpiled to es5
         // TODO: Delete the following 2 lines after we change the build target to >= es2015
-        _this.constructor = AnalyticsError;
-        Object.setPrototypeOf(_this, AnalyticsError.prototype);
-        return _this;
+        this.constructor = AnalyticsError;
+        Object.setPrototypeOf(this, AnalyticsError.prototype);
     }
-    return AnalyticsError;
-}(AmplifyError));
-export { AnalyticsError };
+}

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

@@ -2,4 +2,4 @@ import { AnalyticsValidationErrorCode } from './validation';
 /**
  * @internal
  */
-export declare function assertValidationError(assertion: boolean, name: AnalyticsValidationErrorCode): asserts assertion;
+export declare function assertValidationError(assertion: boolean, name: AnalyticsValidationErrorCode, message?: string): asserts assertion;

package/lib-esm/errors/assertValidationError.js

@@ -5,9 +5,13 @@ import { validationErrorMap } from './validation';
 /**
  * @internal
  */
-export function assertValidationError(assertion, name) {
-    var _a = validationErrorMap[name], message = _a.message, recoverySuggestion = _a.recoverySuggestion;
+export function assertValidationError(assertion, name, message) {
+    const { message: defaultMessage, recoverySuggestion } = validationErrorMap[name];
     if (!assertion) {
-        throw new AnalyticsError({ name: name, message: message, recoverySuggestion: recoverySuggestion });
+        throw new AnalyticsError({
+            name,
+            message: message ?? defaultMessage,
+            recoverySuggestion,
+        });
     }
 }

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

@@ -2,8 +2,11 @@ import { AmplifyErrorMap } from '@aws-amplify/core/internals/utils';
 export declare enum AnalyticsValidationErrorCode {
     NoAppId = "NoAppId",
     NoCredentials = "NoCredentials",
-    NoEvent = "NoEvent",
     NoEventName = "NoEventName",
-    NoRegion = "NoRegion"
+    NoRegion = "NoRegion",
+    InvalidTracker = "InvalidTracker",
+    UnsupportedPlatform = "UnsupportedPlatform",
+    NoTrackingId = "NoTrackingId",
+    InvalidFlushSize = "InvalidFlushSize"
 }
 export declare const validationErrorMap: AmplifyErrorMap<AnalyticsValidationErrorCode>;

package/lib-esm/errors/validation.js

@@ -1,28 +1,39 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-var _a;
 export var AnalyticsValidationErrorCode;
 (function (AnalyticsValidationErrorCode) {
     AnalyticsValidationErrorCode["NoAppId"] = "NoAppId";
     AnalyticsValidationErrorCode["NoCredentials"] = "NoCredentials";
-    AnalyticsValidationErrorCode["NoEvent"] = "NoEvent";
     AnalyticsValidationErrorCode["NoEventName"] = "NoEventName";
     AnalyticsValidationErrorCode["NoRegion"] = "NoRegion";
+    AnalyticsValidationErrorCode["InvalidTracker"] = "InvalidTracker";
+    AnalyticsValidationErrorCode["UnsupportedPlatform"] = "UnsupportedPlatform";
+    AnalyticsValidationErrorCode["NoTrackingId"] = "NoTrackingId";
+    AnalyticsValidationErrorCode["InvalidFlushSize"] = "InvalidFlushSize";
 })(AnalyticsValidationErrorCode || (AnalyticsValidationErrorCode = {}));
-export var validationErrorMap = (_a = {},
-    _a[AnalyticsValidationErrorCode.NoAppId] = {
+export const validationErrorMap = {
+    [AnalyticsValidationErrorCode.NoAppId]: {
         message: 'Missing application id.',
     },
-    _a[AnalyticsValidationErrorCode.NoCredentials] = {
+    [AnalyticsValidationErrorCode.NoCredentials]: {
         message: 'Credentials should not be empty.',
     },
-    _a[AnalyticsValidationErrorCode.NoEvent] = {
-        message: 'An event is required to record.',
-    },
-    _a[AnalyticsValidationErrorCode.NoEventName] = {
+    [AnalyticsValidationErrorCode.NoEventName]: {
         message: 'Events must specify a name.',
     },
-    _a[AnalyticsValidationErrorCode.NoRegion] = {
+    [AnalyticsValidationErrorCode.NoRegion]: {
         message: 'Missing region.',
     },
-    _a);
+    [AnalyticsValidationErrorCode.InvalidTracker]: {
+        message: 'Invalid tracker type specified.',
+    },
+    [AnalyticsValidationErrorCode.UnsupportedPlatform]: {
+        message: 'Only session tracking is supported on React Native.',
+    },
+    [AnalyticsValidationErrorCode.InvalidFlushSize]: {
+        message: 'Invalid FlushSize, it should be smaller than BufferSize',
+    },
+    [AnalyticsValidationErrorCode.NoTrackingId]: {
+        message: 'A trackingId is required to use Amazon Personalize',
+    },
+};

package/lib-esm/index.d.ts

@@ -1,2 +1,3 @@
-export { record, identifyUser, RecordInput, IdentifyUserInput, } 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,4 +1,5 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-export { record, identifyUser, } 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.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Flushes all buffered Kinesis 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-esm/providers/kinesis/apis/flushEvents.js

@@ -0,0 +1,31 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { resolveConfig } from '../utils/resolveConfig';
+import { getAnalyticsUserAgentString, resolveCredentials, } from '../../../utils';
+import { getEventBuffer } from '../utils/getEventBuffer';
+import { AnalyticsAction } from '@aws-amplify/core/internals/utils';
+import { ConsoleLogger } from '@aws-amplify/core';
+const logger = new ConsoleLogger('Kinesis');
+/**
+ * Flushes all buffered Kinesis 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 const flushEvents = () => {
+    const { region, flushSize, flushInterval, bufferSize, resendLimit } = resolveConfig();
+    resolveCredentials()
+        .then(({ credentials, identityId }) => getEventBuffer({
+        region,
+        flushSize,
+        flushInterval,
+        bufferSize,
+        credentials,
+        identityId,
+        resendLimit,
+        userAgentValue: getAnalyticsUserAgentString(AnalyticsAction.Record),
+    }))
+        .then(eventBuffer => eventBuffer.flushAll())
+        .catch(e => logger.warn('Failed to flush events.', e));
+};

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

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

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

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

package/lib-esm/providers/kinesis/apis/record.d.ts

@@ -0,0 +1,2 @@
+import { RecordInput } from '../types';
+export declare const record: ({ streamName, partitionKey, data, }: RecordInput) => void;