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

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>;

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

@@ -0,0 +1,68 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { EventBuffer, groupBy } from '../../../utils';
+import { KinesisClient, PutRecordsCommand } from '@aws-sdk/client-kinesis';
+/**
+ * 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.
+ * */
+const eventBufferMap = {};
+const cachedClients = {};
+const createKinesisPutRecordsCommand = (streamName, events) => new PutRecordsCommand({
+    StreamName: streamName,
+    Records: events.map(event => ({
+        PartitionKey: event.partitionKey,
+        Data: event.event,
+    })),
+});
+const submitEvents = async (events, client, resendLimit) => {
+    const groupedByStreamName = Object.entries(groupBy(event => event.streamName, events));
+    const requests = groupedByStreamName
+        .map(([streamName, events]) => createKinesisPutRecordsCommand(streamName, events))
+        .map(command => client.send(command));
+    const responses = await Promise.allSettled(requests);
+    const failedEvents = responses
+        .map((response, i) => response.status === 'rejected' ? groupedByStreamName[i][1] : [])
+        .flat();
+    return resendLimit
+        ? failedEvents
+            .filter(event => event.retryCount < resendLimit)
+            .map(event => ({ ...event, retryCount: event.retryCount + 1 }))
+            .sort((a, b) => a.timestamp - b.timestamp)
+        : [];
+};
+export const getEventBuffer = ({ region, flushInterval, flushSize, bufferSize, credentials, identityId, resendLimit, userAgentValue, }) => {
+    const sessionIdentityKey = [region, identityId].filter(x => !!x).join('-');
+    if (!eventBufferMap[sessionIdentityKey]) {
+        const getKinesisClient = () => {
+            if (!cachedClients[sessionIdentityKey]) {
+                cachedClients[sessionIdentityKey] = new KinesisClient({
+                    credentials,
+                    region,
+                    customUserAgent: userAgentValue,
+                });
+            }
+            return events => submitEvents(events, cachedClients[sessionIdentityKey], resendLimit);
+        };
+        // create new session
+        eventBufferMap[sessionIdentityKey] = new EventBuffer({
+            flushInterval,
+            flushSize,
+            bufferSize,
+        }, getKinesisClient);
+        // release other sessions
+        const releaseSessionKeys = Object.keys(eventBufferMap).filter(x => x !== sessionIdentityKey);
+        for (const releaseSessionKey of releaseSessionKeys) {
+            eventBufferMap[releaseSessionKey].flushAll().finally(() => {
+                eventBufferMap[releaseSessionKey].release();
+                delete eventBufferMap[releaseSessionKey];
+                delete cachedClients[releaseSessionKey];
+            });
+        }
+    }
+    return eventBufferMap[sessionIdentityKey];
+};

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

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

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

@@ -0,0 +1,21 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { Amplify } from '@aws-amplify/core';
+import { AnalyticsValidationErrorCode, assertValidationError, } from '../../../errors';
+import { DEFAULT_KINESIS_CONFIG } from './constants';
+export const resolveConfig = () => {
+    const config = Amplify.getConfig().Analytics?.Kinesis;
+    const { region, bufferSize = DEFAULT_KINESIS_CONFIG.bufferSize, flushSize = DEFAULT_KINESIS_CONFIG.flushSize, flushInterval = DEFAULT_KINESIS_CONFIG.flushInterval, resendLimit, } = {
+        ...DEFAULT_KINESIS_CONFIG,
+        ...config,
+    };
+    assertValidationError(!!region, AnalyticsValidationErrorCode.NoRegion);
+    assertValidationError(flushSize < bufferSize, AnalyticsValidationErrorCode.InvalidFlushSize);
+    return {
+        region,
+        bufferSize,
+        flushSize,
+        flushInterval,
+        resendLimit,
+    };
+};

package/lib-esm/providers/kinesis-firehose/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-firehose/apis/flushEvents.js

@@ -0,0 +1,30 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { getEventBuffer, resolveConfig } from '../utils';
+import { getAnalyticsUserAgentString, resolveCredentials, } from '../../../utils';
+import { AnalyticsAction } from '@aws-amplify/core/internals/utils';
+import { ConsoleLogger } from '@aws-amplify/core';
+const logger = new ConsoleLogger('KinesisFirehose');
+/**
+ * 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-firehose/apis/index.d.ts

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

package/lib-esm/providers/kinesis-firehose/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-firehose/apis/record.d.ts

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

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

@@ -0,0 +1,39 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { getEventBuffer, resolveConfig } from '../utils';
+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('KinesisFirehose');
+export const record = ({ streamName, 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,
+            credentials,
+            identityId,
+            bufferSize,
+            flushSize,
+            flushInterval,
+            resendLimit,
+            userAgentValue: getAnalyticsUserAgentString(AnalyticsAction.Record),
+        });
+        buffer.append({
+            region,
+            streamName,
+            event: ArrayBuffer.isView(data) ? data : fromUtf8(JSON.stringify(data)),
+            timestamp,
+            retryCount: 0,
+        });
+    })
+        .catch(e => {
+        logger.warn('Failed to record event.', e);
+    });
+};

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

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

package/lib-esm/providers/kinesis-firehose/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-firehose/types/buffer.d.ts

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

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

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

package/lib-esm/providers/kinesis-firehose/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-firehose/types/inputs.d.ts

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

package/lib-esm/providers/kinesis-firehose/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-firehose/utils/constants.d.ts

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

package/lib-esm/providers/kinesis-firehose/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_FIREHOSE_CONFIG = {
+    bufferSize: 1000,
+    flushSize: 100,
+    flushInterval: 5000,
+    resendLimit: 5,
+};

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

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

package/lib-esm/providers/kinesis-firehose/utils/getEventBuffer.js

@@ -0,0 +1,67 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { EventBuffer, groupBy } from '../../../utils';
+import { FirehoseClient, PutRecordBatchCommand, } from '@aws-sdk/client-firehose';
+/**
+ * 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.
+ * */
+const eventBufferMap = {};
+const cachedClients = {};
+const createPutRecordsBatchCommand = (streamName, events) => new PutRecordBatchCommand({
+    DeliveryStreamName: streamName,
+    Records: events.map(event => ({
+        Data: event.event,
+    })),
+});
+const submitEvents = async (events, client, resendLimit) => {
+    const groupedByStreamName = Object.entries(groupBy(event => event.streamName, events));
+    const requests = groupedByStreamName
+        .map(([streamName, events]) => createPutRecordsBatchCommand(streamName, events))
+        .map(command => client.send(command));
+    const responses = await Promise.allSettled(requests);
+    const failedEvents = responses
+        .map((response, i) => response.status === 'rejected' ? groupedByStreamName[i][1] : [])
+        .flat();
+    return resendLimit
+        ? failedEvents
+            .filter(event => event.retryCount < resendLimit)
+            .map(event => ({ ...event, retryCount: event.retryCount + 1 }))
+            .sort((a, b) => a.timestamp - b.timestamp)
+        : [];
+};
+export const getEventBuffer = ({ region, credentials, identityId, bufferSize, flushSize, flushInterval, resendLimit, userAgentValue, }) => {
+    const sessionIdentityKey = [region, identityId].filter(id => !!id).join('-');
+    if (!eventBufferMap[sessionIdentityKey]) {
+        const getClient = () => {
+            if (!cachedClients[sessionIdentityKey]) {
+                cachedClients[sessionIdentityKey] = new FirehoseClient({
+                    region,
+                    credentials,
+                    customUserAgent: userAgentValue,
+                });
+            }
+            const firehoseClient = cachedClients[sessionIdentityKey];
+            return events => submitEvents(events, firehoseClient, resendLimit);
+        };
+        eventBufferMap[sessionIdentityKey] =
+            new EventBuffer({
+                bufferSize,
+                flushSize,
+                flushInterval,
+            }, getClient);
+        const releaseSessionKeys = Object.keys(eventBufferMap).filter(key => key !== sessionIdentityKey);
+        for (const releaseSessionKey of releaseSessionKeys) {
+            eventBufferMap[releaseSessionKey].flushAll().finally(() => {
+                eventBufferMap[releaseSessionKey].release();
+                delete eventBufferMap[releaseSessionKey];
+                delete cachedClients[releaseSessionKey];
+            });
+        }
+    }
+    return eventBufferMap[sessionIdentityKey];
+};

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

@@ -0,0 +1,2 @@
+export { getEventBuffer } from './getEventBuffer';
+export { resolveConfig } from './resolveConfig';

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

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

package/lib-esm/providers/kinesis-firehose/utils/resolveConfig.d.ts

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

package/lib-esm/providers/kinesis-firehose/utils/resolveConfig.js

@@ -0,0 +1,21 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { Amplify } from '@aws-amplify/core';
+import { AnalyticsValidationErrorCode, assertValidationError, } from '../../../errors';
+import { DEFAULT_KINESIS_FIREHOSE_CONFIG } from './constants';
+export const resolveConfig = () => {
+    const config = Amplify.getConfig().Analytics?.KinesisFirehose;
+    const { region, bufferSize = DEFAULT_KINESIS_FIREHOSE_CONFIG.bufferSize, flushSize = DEFAULT_KINESIS_FIREHOSE_CONFIG.flushSize, flushInterval = DEFAULT_KINESIS_FIREHOSE_CONFIG.flushInterval, resendLimit, } = {
+        ...DEFAULT_KINESIS_FIREHOSE_CONFIG,
+        ...config,
+    };
+    assertValidationError(!!region, AnalyticsValidationErrorCode.NoRegion);
+    assertValidationError(flushSize < bufferSize, AnalyticsValidationErrorCode.InvalidFlushSize);
+    return {
+        region,
+        bufferSize,
+        flushSize,
+        flushInterval,
+        resendLimit,
+    };
+};

package/lib-esm/providers/personalize/apis/flushEvents.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Flushes all buffered Personalize 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/personalize/apis/flushEvents.js

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

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

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

package/lib-esm/providers/personalize/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/personalize/apis/record.d.ts

@@ -0,0 +1,2 @@
+import { RecordInput } from '../types';
+export declare const record: ({ userId, eventId, eventType, properties, }: RecordInput) => void;

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

@@ -0,0 +1,67 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { autoTrackMedia, getEventBuffer, resolveCachedSession, resolveConfig, updateCachedSession, } from '../utils';
+import { getAnalyticsUserAgentString, isAnalyticsEnabled, resolveCredentials, } from '../../../utils';
+import { AnalyticsAction } from '@aws-amplify/core/internals/utils';
+import { ConsoleLogger } from '@aws-amplify/core';
+import { IDENTIFY_EVENT_TYPE, MEDIA_AUTO_TRACK_EVENT_TYPE, } from '../utils/constants';
+const logger = new ConsoleLogger('Personalize');
+export const record = ({ userId, eventId, eventType, properties, }) => {
+    if (!isAnalyticsEnabled()) {
+        logger.debug('Analytics is disabled, event will not be recorded.');
+        return;
+    }
+    const { region, trackingId, bufferSize, flushSize, flushInterval } = resolveConfig();
+    resolveCredentials()
+        .then(async ({ credentials, identityId }) => {
+        const timestamp = Date.now();
+        const { sessionId: cachedSessionId, userId: cachedUserId } = await resolveCachedSession();
+        if (eventType === IDENTIFY_EVENT_TYPE) {
+            updateCachedSession(typeof properties.userId === 'string' ? properties.userId : '', cachedSessionId, cachedUserId);
+        }
+        else if (!!userId) {
+            updateCachedSession(userId, cachedSessionId, cachedUserId);
+        }
+        const { sessionId: updatedSessionId, userId: updatedUserId } = await resolveCachedSession();
+        const eventBuffer = getEventBuffer({
+            region,
+            flushSize,
+            flushInterval,
+            bufferSize,
+            credentials,
+            identityId,
+            userAgentValue: getAnalyticsUserAgentString(AnalyticsAction.Record),
+        });
+        if (eventType === MEDIA_AUTO_TRACK_EVENT_TYPE) {
+            autoTrackMedia({
+                trackingId,
+                sessionId: updatedSessionId,
+                userId: updatedUserId,
+                event: {
+                    eventId,
+                    eventType,
+                    properties,
+                },
+            }, eventBuffer);
+        }
+        else {
+            eventBuffer.append({
+                trackingId,
+                sessionId: updatedSessionId,
+                userId: updatedUserId,
+                event: {
+                    eventId,
+                    eventType,
+                    properties,
+                },
+                timestamp,
+            });
+        }
+        if (eventBuffer.length >= bufferSize) {
+            eventBuffer.flushAll();
+        }
+    })
+        .catch(e => {
+        logger.warn('Failed to record event.', e);
+    });
+};

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

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

package/lib-esm/providers/personalize/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/personalize/types/buffer.d.ts

@@ -0,0 +1,16 @@
+import { PersonalizeEvent } from './';
+import { EventBufferConfig } from '../../../utils';
+import { AWSCredentials } from '@aws-amplify/core/internals/utils';
+export type PersonalizeBufferEvent = {
+    trackingId: string;
+    sessionId?: string;
+    userId?: string;
+    event: PersonalizeEvent;
+    timestamp: number;
+};
+export type PersonalizeBufferConfig = EventBufferConfig & {
+    region: string;
+    credentials: AWSCredentials;
+    identityId?: string;
+    userAgentValue?: string;
+};

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

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