@aws-amplify/analytics 6.5.6-api-v6-models.b3abc9b.0 → 7.0.0

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.d.ts → userAgent.d.ts}

@@ -1,4 +1,4 @@
-import { AnalyticsAction } from '@aws-amplify/core';
+import { AnalyticsAction } from '@aws-amplify/core/internals/utils';
 import { UserAgent } from '@aws-sdk/types';
 export declare function getAnalyticsUserAgent(action: AnalyticsAction): UserAgent;
 export declare function getAnalyticsUserAgentString(action: AnalyticsAction): string;

package/lib/utils/{UserAgent.js → userAgent.js}

@@ -1,20 +1,20 @@
 "use strict";
 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 core_1 = require("@aws-amplify/core");
+const utils_1 = require("@aws-amplify/core/internals/utils");
 function getAnalyticsUserAgent(action) {
-    return core_1.getAmplifyUserAgentObject({
-        category: core_1.Category.Analytics,
-        action: action,
+    return (0, utils_1.getAmplifyUserAgentObject)({
+        category: utils_1.Category.Analytics,
+        action,
     });
 }
 exports.getAnalyticsUserAgent = getAnalyticsUserAgent;
 function getAnalyticsUserAgentString(action) {
-    return core_1.getAmplifyUserAgent({
-        category: core_1.Category.Analytics,
-        action: action,
+    return (0, utils_1.getAmplifyUserAgent)({
+        category: utils_1.Category.Analytics,
+        action,
     });
 }
 exports.getAnalyticsUserAgentString = getAnalyticsUserAgentString;
-//# sourceMappingURL=UserAgent.js.map

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

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

package/lib-esm/errors/AnalyticsError.js

@@ -0,0 +1,15 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { AmplifyError, } from '@aws-amplify/core/internals/utils';
+/**
+ * @internal
+ */
+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);
+    }
+}

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

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

package/lib-esm/errors/assertValidationError.js

@@ -0,0 +1,17 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { AnalyticsError } from './AnalyticsError';
+import { validationErrorMap } from './validation';
+/**
+ * @internal
+ */
+export function assertValidationError(assertion, name, message) {
+    const { message: defaultMessage, recoverySuggestion } = validationErrorMap[name];
+    if (!assertion) {
+        throw new AnalyticsError({
+            name,
+            message: message ?? defaultMessage,
+            recoverySuggestion,
+        });
+    }
+}

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

@@ -0,0 +1,3 @@
+export { AnalyticsError } from './AnalyticsError';
+export { assertValidationError } from './assertValidationError';
+export { AnalyticsValidationErrorCode, validationErrorMap } from './validation';

package/lib-esm/errors/index.js

@@ -0,0 +1,5 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+export { AnalyticsError } from './AnalyticsError';
+export { assertValidationError } from './assertValidationError';
+export { AnalyticsValidationErrorCode, validationErrorMap } from './validation';

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

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

package/lib-esm/errors/validation.js

@@ -0,0 +1,39 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+export var AnalyticsValidationErrorCode;
+(function (AnalyticsValidationErrorCode) {
+    AnalyticsValidationErrorCode["NoAppId"] = "NoAppId";
+    AnalyticsValidationErrorCode["NoCredentials"] = "NoCredentials";
+    AnalyticsValidationErrorCode["NoEventName"] = "NoEventName";
+    AnalyticsValidationErrorCode["NoRegion"] = "NoRegion";
+    AnalyticsValidationErrorCode["InvalidTracker"] = "InvalidTracker";
+    AnalyticsValidationErrorCode["UnsupportedPlatform"] = "UnsupportedPlatform";
+    AnalyticsValidationErrorCode["NoTrackingId"] = "NoTrackingId";
+    AnalyticsValidationErrorCode["InvalidFlushSize"] = "InvalidFlushSize";
+})(AnalyticsValidationErrorCode || (AnalyticsValidationErrorCode = {}));
+export const validationErrorMap = {
+    [AnalyticsValidationErrorCode.NoAppId]: {
+        message: 'Missing application id.',
+    },
+    [AnalyticsValidationErrorCode.NoCredentials]: {
+        message: 'Credentials should not be empty.',
+    },
+    [AnalyticsValidationErrorCode.NoEventName]: {
+        message: 'Events must specify a name.',
+    },
+    [AnalyticsValidationErrorCode.NoRegion]: {
+        message: 'Missing region.',
+    },
+    [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,3 +1,3 @@
-export { Analytics } from './Analytics';
-export { AnalyticsProvider } from './types';
-export { AWSPinpointProvider, AWSKinesisProvider, AWSKinesisFirehoseProvider, AmazonPersonalizeProvider, } from './Providers';
+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 { Analytics } from './Analytics';
-export { AWSPinpointProvider, AWSKinesisProvider, AWSKinesisFirehoseProvider, AmazonPersonalizeProvider, } from './Providers';
-//# sourceMappingURL=index.js.map
+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;

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

@@ -0,0 +1,42 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { getEventBuffer } from '../utils/getEventBuffer';
+import { resolveConfig } from '../utils/resolveConfig';
+import { getAnalyticsUserAgentString, isAnalyticsEnabled, resolveCredentials, } from '../../../utils';
+import { fromUtf8 } from '@smithy/util-utf8';
+import { AnalyticsAction } from '@aws-amplify/core/internals/utils';
+import { ConsoleLogger } from '@aws-amplify/core';
+const logger = new ConsoleLogger('Kinesis');
+export const record = ({ streamName, partitionKey, data, }) => {
+    if (!isAnalyticsEnabled()) {
+        logger.debug('Analytics is disabled, event will not be recorded.');
+        return;
+    }
+    const timestamp = Date.now();
+    const { region, bufferSize, flushSize, flushInterval, resendLimit } = resolveConfig();
+    resolveCredentials()
+        .then(({ credentials, identityId }) => {
+        const buffer = getEventBuffer({
+            region,
+            bufferSize,
+            flushSize,
+            flushInterval,
+            credentials,
+            identityId,
+            resendLimit,
+            userAgentValue: getAnalyticsUserAgentString(AnalyticsAction.Record),
+        });
+        buffer.append({
+            region,
+            streamName,
+            partitionKey,
+            event: ArrayBuffer.isView(data) ? data : fromUtf8(JSON.stringify(data)),
+            timestamp,
+            retryCount: 0,
+        });
+    })
+        .catch(e => {
+        // An error occured while fetching credentials or persisting the event to the buffer
+        logger.warn('Failed to record event.', e);
+    });
+};

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

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

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

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

package/lib-esm/providers/kinesis/types/buffer.d.ts

@@ -0,0 +1,15 @@
+import { AWSCredentials } from '@aws-amplify/core/internals/utils';
+import { EventBufferConfig } from '../../../utils';
+import { KinesisShard } from '../../../types';
+export type KinesisBufferEvent = KinesisShard & {
+    event: Uint8Array;
+    timestamp: number;
+    retryCount: number;
+};
+export type KinesisEventBufferConfig = EventBufferConfig & {
+    region: string;
+    credentials: AWSCredentials;
+    identityId?: string;
+    resendLimit?: number;
+    userAgentValue?: string;
+};

package/lib-esm/providers/kinesis/types/buffer.js

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

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

@@ -0,0 +1,2 @@
+export { RecordInput } from './inputs';
+export { KinesisBufferEvent, KinesisEventBufferConfig } from './buffer';

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

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

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

@@ -0,0 +1,6 @@
+import { KinesisEventData } from '../../../types';
+export type RecordInput = {
+    streamName: string;
+    partitionKey: string;
+    data: KinesisEventData;
+};

package/lib-esm/providers/kinesis/types/inputs.js

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

package/lib-esm/providers/kinesis/utils/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const DEFAULT_KINESIS_CONFIG: {
+    bufferSize: number;
+    flushSize: number;
+    flushInterval: number;
+    resendLimit: number;
+};

package/lib-esm/providers/kinesis/utils/constants.js

@@ -0,0 +1,8 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+export const DEFAULT_KINESIS_CONFIG = {
+    bufferSize: 1000,
+    flushSize: 100,
+    flushInterval: 5000,
+    resendLimit: 5,
+};

package/lib-esm/providers/kinesis/utils/getEventBuffer.d.ts

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