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

package/lib-esm/types/options.d.ts

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

package/lib-esm/types/options.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/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-esm/types/trackers.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/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-esm/utils/eventBuffer/EventBuffer.js

@@ -0,0 +1,59 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { ConsoleLogger } from '@aws-amplify/core';
+const logger = new ConsoleLogger('EventBuffer');
+export 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);
+            }
+        });
+    }
+}

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

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

package/lib-esm/utils/eventBuffer/index.js

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

package/lib-esm/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-esm/utils/eventBuffer/types.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/utils/groupBy.d.ts

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

package/lib-esm/utils/groupBy.js

@@ -0,0 +1,8 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+export const groupBy = (getGroupId, list) => {
+    return list.reduce((result, current) => {
+        const groupId = getGroupId(current);
+        return { ...result, [groupId]: [...(result[groupId] ?? []), current] };
+    }, {});
+};

package/lib-esm/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-esm/utils/index.js

@@ -0,0 +1,9 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+export { resolveCredentials } from './resolveCredentials';
+export { groupBy } from './groupBy';
+export { EventBuffer, } from './eventBuffer';
+export { enableAnalytics, disableAnalytics, isAnalyticsEnabled, } from './statusHelpers';
+export { getAnalyticsUserAgent, getAnalyticsUserAgentString, } from './userAgent';
+export { updateProviderTrackers } from './trackerHelpers';
+export { validateTrackerConfiguration } from './trackerConfigHelpers';

package/lib-esm/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-esm/utils/resolveCredentials.js

@@ -0,0 +1,9 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { AnalyticsValidationErrorCode, assertValidationError } from '../errors';
+import { fetchAuthSession } from '@aws-amplify/core';
+export const resolveCredentials = async () => {
+    const { credentials, identityId } = await fetchAuthSession();
+    assertValidationError(!!credentials, AnalyticsValidationErrorCode.NoCredentials);
+    return { credentials, identityId };
+};

package/lib-esm/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-esm/utils/statusHelpers.js

@@ -0,0 +1,13 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+let analyticsEnabled = true;
+export const enableAnalytics = () => {
+    analyticsEnabled = true;
+};
+export const disableAnalytics = () => {
+    analyticsEnabled = false;
+};
+/**
+ * Returns the current status of the Analytics category.
+ */
+export const isAnalyticsEnabled = () => analyticsEnabled;

package/lib-esm/utils/trackerConfigHelpers.d.ts

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

package/lib-esm/utils/trackerConfigHelpers.js

@@ -0,0 +1,11 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { AnalyticsValidationErrorCode, assertValidationError } from '../errors';
+/**
+ * Validates tracker configuration.
+ */
+export const validateTrackerConfiguration = (input) => {
+    assertValidationError(input.type === 'event' ||
+        input.type === 'pageView' ||
+        input.type === 'session', AnalyticsValidationErrorCode.InvalidTracker);
+};

package/lib-esm/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-esm/utils/trackerConfigHelpers.native.js

@@ -0,0 +1,10 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { AnalyticsValidationErrorCode, assertValidationError } from '../errors';
+/**
+ * Validates tracker configuration.
+ */
+export const validateTrackerConfiguration = (input) => {
+    // React Native only supports session tracking
+    assertValidationError(input.type === 'session', AnalyticsValidationErrorCode.UnsupportedPlatform);
+};

package/lib-esm/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-esm/utils/trackerHelpers.js

@@ -0,0 +1,40 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { EventTracker, PageViewTracker, SessionTracker } from '../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`.
+ */
+export 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 EventTracker(providerEventRecorder, input.options);
+    }
+    else if (trackerType === 'pageView') {
+        trackerInstance = new PageViewTracker(providerEventRecorder, input.options);
+    }
+    else if (trackerType === 'session') {
+        trackerInstance = new SessionTracker(providerEventRecorder, input.options);
+    }
+    if (trackerInstance) {
+        providerTrackers[trackerType] = trackerInstance;
+    }
+};

package/lib-esm/utils/userAgent.js

@@ -4,12 +4,12 @@ import { Category, getAmplifyUserAgentObject, getAmplifyUserAgent, } from '@aws-
 export function getAnalyticsUserAgent(action) {
     return getAmplifyUserAgentObject({
         category: Category.Analytics,
-        action: action,
+        action,
     });
 }
 export function getAnalyticsUserAgentString(action) {
     return getAmplifyUserAgent({
         category: Category.Analytics,
-        action: action,
+        action,
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws-amplify/analytics",
-  "version": "7.0.1-preview-testing.be90020.0+be90020",
+  "version": "7.0.1-ssr-api.df60e41.0+df60e41",
   "description": "Analytics category of aws-amplify",
   "main": "./lib/index.js",
   "module": "./lib-esm/index.js",
@@ -26,12 +26,18 @@
   },
   "react-native": "./lib-esm/index.js",
   "typesVersions": {
-    ">=3.8": {
-      "*": [
-        "./lib-esm/index.d.ts"
-      ],
+    ">=4.2": {
       "pinpoint": [
         "./lib-esm/providers/pinpoint/index.d.ts"
+      ],
+      "kinesis": [
+        "./lib-esm/providers/kinesis/index.d.ts"
+      ],
+      "kinesis-firehose": [
+        "./lib-esm/providers/kinesis-firehose/index.d.ts"
+      ],
+      "personalize": [
+        "./lib-esm/providers/personalize/index.d.ts"
       ]
     }
   },
@@ -46,6 +52,21 @@
       "import": "./lib-esm/providers/pinpoint/index.js",
       "require": "./lib/providers/pinpoint/index.js"
     },
+    "./kinesis": {
+      "types": "./lib-esm/providers/kinesis/index.d.ts",
+      "import": "./lib-esm/providers/kinesis/index.js",
+      "require": "./lib/providers/kinesis/index.js"
+    },
+    "./kinesis-firehose": {
+      "types": "./lib-esm/providers/kinesis-firehose/index.d.ts",
+      "import": "./lib-esm/providers/kinesis-firehose/index.js",
+      "require": "./lib/providers/kinesis-firehose/index.js"
+    },
+    "./personalize": {
+      "types": "./lib-esm/providers/personalize/index.d.ts",
+      "import": "./lib-esm/providers/personalize/index.js",
+      "require": "./lib/providers/personalize/index.js"
+    },
     "./package.json": "./package.json"
   },
   "repository": {
@@ -62,19 +83,25 @@
     "lib",
     "lib-esm",
     "src",
-    "pinpoint"
+    "pinpoint",
+    "kinesis",
+    "kinesis-firehose",
+    "personalize"
   ],
   "dependencies": {
-    "tslib": "^2.5.0",
-    "uuid": "^9.0.0"
+    "@aws-sdk/client-firehose": "3.398.0",
+    "@aws-sdk/client-kinesis": "3.398.0",
+    "@aws-sdk/client-personalize-events": "3.398.0",
+    "@smithy/util-utf8": "2.0.0",
+    "tslib": "^2.5.0"
   },
   "peerDependencies": {
-    "@aws-amplify/core": "6.0.1-preview-testing.be90020.0+be90020"
+    "@aws-amplify/core": "6.0.1-ssr-api.df60e41.0+df60e41"
   },
   "devDependencies": {
-    "@aws-amplify/core": "6.0.1-preview-testing.be90020.0+be90020",
+    "@aws-amplify/core": "6.0.1-ssr-api.df60e41.0+df60e41",
+    "@aws-amplify/react-native": "1.0.1-ssr-api.df60e41.0+df60e41",
     "@aws-sdk/types": "3.398.0",
-    "@types/uuid": "^9.0.0",
     "typescript": "5.0.2"
   },
   "jest": {
@@ -121,5 +148,5 @@
       "<rootDir>/src/setupTests.ts"
     ]
   },
-  "gitHead": "be9002044ab6c76669c39ba512c6ee0bc2936a2f"
+  "gitHead": "df60e41fbc70bd6277162b7780b3fc030c93c6a0"
 }

package/personalize/package.json

@@ -0,0 +1,7 @@
+{
+  "name": "@aws-amplify/analytics/personalize",
+  "main": "../lib/providers/personalize/index.js",
+  "browser": "../lib-esm/providers/personalize/index.js",
+  "module": "../lib-esm/providers/personalize/index.js",
+  "typings": "../lib-esm/providers/personalize/index.d.ts"
+}

package/src/apis/disable.ts

@@ -0,0 +1,13 @@
+// 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/src/apis/enable.ts

@@ -0,0 +1,12 @@
+// 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/src/apis/index.ts

@@ -0,0 +1,5 @@
+// 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/src/errors/AnalyticsError.ts

@@ -1,13 +1,16 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
 
-import { AmplifyError, ErrorParams } from '@aws-amplify/core/internals/utils';
+import {
+	AmplifyError,
+	AmplifyErrorParams,
+} from '@aws-amplify/core/internals/utils';
 
 /**
  * @internal
  */
 export class AnalyticsError extends AmplifyError {
-	constructor(params: ErrorParams) {
+	constructor(params: AmplifyErrorParams) {
 		super(params);
 
 		// Hack for making the custom error class work when transpiled to es5

package/src/errors/assertValidationError.ts

@@ -9,11 +9,17 @@ import { AnalyticsValidationErrorCode, validationErrorMap } from './validation';
  */
 export function assertValidationError(
 	assertion: boolean,
-	name: AnalyticsValidationErrorCode
+	name: AnalyticsValidationErrorCode,
+	message?: string
 ): asserts assertion {
-	const { message, recoverySuggestion } = validationErrorMap[name];
+	const { message: defaultMessage, recoverySuggestion } =
+		validationErrorMap[name];
 
 	if (!assertion) {
-		throw new AnalyticsError({ name, message, recoverySuggestion });
+		throw new AnalyticsError({
+			name,
+			message: message ?? defaultMessage,
+			recoverySuggestion,
+		});
 	}
 }

package/src/errors/validation.ts

@@ -6,9 +6,12 @@ import { AmplifyErrorMap } from '@aws-amplify/core/internals/utils';
 export enum AnalyticsValidationErrorCode {
 	NoAppId = 'NoAppId',
 	NoCredentials = 'NoCredentials',
-	NoEvent = 'NoEvent',
 	NoEventName = 'NoEventName',
 	NoRegion = 'NoRegion',
+	InvalidTracker = 'InvalidTracker',
+	UnsupportedPlatform = 'UnsupportedPlatform',
+	NoTrackingId = 'NoTrackingId',
+	InvalidFlushSize = 'InvalidFlushSize',
 }
 
 export const validationErrorMap: AmplifyErrorMap<AnalyticsValidationErrorCode> =
@@ -19,13 +22,22 @@ export const validationErrorMap: AmplifyErrorMap<AnalyticsValidationErrorCode> =
 		[AnalyticsValidationErrorCode.NoCredentials]: {
 			message: 'Credentials should not be empty.',
 		},
-		[AnalyticsValidationErrorCode.NoEvent]: {
-			message: 'An event is required to record.',
-		},
 		[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/src/index.ts

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

package/src/providers/kinesis/apis/flushEvents.ts

@@ -0,0 +1,40 @@
+// 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/src/providers/kinesis/apis/index.ts

@@ -0,0 +1,5 @@
+// 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/src/providers/kinesis/apis/record.ts

@@ -0,0 +1,58 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+import { RecordInput } from '../types';
+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,
+}: RecordInput): void => {
+	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);
+		});
+};