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

package/kinesis/package.json

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

package/kinesis-firehose/package.json

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

package/lib/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/apis/disable.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.disable = void 0;
+const utils_1 = require("../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.
+ */
+exports.disable = utils_1.disableAnalytics;

package/lib/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/apis/enable.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.enable = void 0;
+const utils_1 = require("../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.
+ */
+exports.enable = utils_1.enableAnalytics;

package/lib/apis/index.d.ts

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

package/lib/apis/index.js

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

package/lib/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/errors/AnalyticsError.js

@@ -3,21 +3,17 @@
 // SPDX-License-Identifier: Apache-2.0
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AnalyticsError = void 0;
-var tslib_1 = require("tslib");
-var utils_1 = require("@aws-amplify/core/internals/utils");
+const utils_1 = require("@aws-amplify/core/internals/utils");
 /**
  * @internal
  */
-var AnalyticsError = /** @class */ (function (_super) {
-    tslib_1.__extends(AnalyticsError, _super);
-    function AnalyticsError(params) {
-        var _this = _super.call(this, params) || this;
+class AnalyticsError extends utils_1.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;
-}(utils_1.AmplifyError));
+}
 exports.AnalyticsError = AnalyticsError;

package/lib/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/errors/assertValidationError.js

@@ -3,15 +3,19 @@
 // SPDX-License-Identifier: Apache-2.0
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.assertValidationError = void 0;
-var AnalyticsError_1 = require("./AnalyticsError");
-var validation_1 = require("./validation");
+const AnalyticsError_1 = require("./AnalyticsError");
+const validation_1 = require("./validation");
 /**
  * @internal
  */
-function assertValidationError(assertion, name) {
-    var _a = validation_1.validationErrorMap[name], message = _a.message, recoverySuggestion = _a.recoverySuggestion;
+function assertValidationError(assertion, name, message) {
+    const { message: defaultMessage, recoverySuggestion } = validation_1.validationErrorMap[name];
     if (!assertion) {
-        throw new AnalyticsError_1.AnalyticsError({ name: name, message: message, recoverySuggestion: recoverySuggestion });
+        throw new AnalyticsError_1.AnalyticsError({
+            name,
+            message: message ?? defaultMessage,
+            recoverySuggestion,
+        });
     }
 }
 exports.assertValidationError = assertValidationError;

package/lib/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/errors/validation.js

@@ -1,31 +1,42 @@
 "use strict";
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validationErrorMap = exports.AnalyticsValidationErrorCode = void 0;
 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 = exports.AnalyticsValidationErrorCode || (exports.AnalyticsValidationErrorCode = {}));
-exports.validationErrorMap = (_a = {},
-    _a[AnalyticsValidationErrorCode.NoAppId] = {
+exports.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/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/index.js

@@ -2,9 +2,14 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AnalyticsError = exports.identifyUser = exports.record = void 0;
+exports.AnalyticsError = exports.disable = exports.enable = exports.flushEvents = exports.configureAutoTrack = exports.identifyUser = exports.record = void 0;
 var pinpoint_1 = require("./providers/pinpoint");
 Object.defineProperty(exports, "record", { enumerable: true, get: function () { return pinpoint_1.record; } });
 Object.defineProperty(exports, "identifyUser", { enumerable: true, get: function () { return pinpoint_1.identifyUser; } });
+Object.defineProperty(exports, "configureAutoTrack", { enumerable: true, get: function () { return pinpoint_1.configureAutoTrack; } });
+Object.defineProperty(exports, "flushEvents", { enumerable: true, get: function () { return pinpoint_1.flushEvents; } });
+var apis_1 = require("./apis");
+Object.defineProperty(exports, "enable", { enumerable: true, get: function () { return apis_1.enable; } });
+Object.defineProperty(exports, "disable", { enumerable: true, get: function () { return apis_1.disable; } });
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "AnalyticsError", { enumerable: true, get: function () { return errors_1.AnalyticsError; } });

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

@@ -0,0 +1,35 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flushEvents = void 0;
+const resolveConfig_1 = require("../utils/resolveConfig");
+const utils_1 = require("../../../utils");
+const getEventBuffer_1 = require("../utils/getEventBuffer");
+const utils_2 = require("@aws-amplify/core/internals/utils");
+const core_1 = require("@aws-amplify/core");
+const logger = new core_1.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.
+ */
+const flushEvents = () => {
+    const { region, flushSize, flushInterval, bufferSize, resendLimit } = (0, resolveConfig_1.resolveConfig)();
+    (0, utils_1.resolveCredentials)()
+        .then(({ credentials, identityId }) => (0, getEventBuffer_1.getEventBuffer)({
+        region,
+        flushSize,
+        flushInterval,
+        bufferSize,
+        credentials,
+        identityId,
+        resendLimit,
+        userAgentValue: (0, utils_1.getAnalyticsUserAgentString)(utils_2.AnalyticsAction.Record),
+    }))
+        .then(eventBuffer => eventBuffer.flushAll())
+        .catch(e => logger.warn('Failed to flush events.', e));
+};
+exports.flushEvents = flushEvents;

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

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

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

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

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

@@ -0,0 +1,46 @@
+"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.record = void 0;
+const getEventBuffer_1 = require("../utils/getEventBuffer");
+const resolveConfig_1 = require("../utils/resolveConfig");
+const utils_1 = require("../../../utils");
+const util_utf8_1 = require("@smithy/util-utf8");
+const utils_2 = require("@aws-amplify/core/internals/utils");
+const core_1 = require("@aws-amplify/core");
+const logger = new core_1.ConsoleLogger('Kinesis');
+const record = ({ streamName, partitionKey, data, }) => {
+    if (!(0, utils_1.isAnalyticsEnabled)()) {
+        logger.debug('Analytics is disabled, event will not be recorded.');
+        return;
+    }
+    const timestamp = Date.now();
+    const { region, bufferSize, flushSize, flushInterval, resendLimit } = (0, resolveConfig_1.resolveConfig)();
+    (0, utils_1.resolveCredentials)()
+        .then(({ credentials, identityId }) => {
+        const buffer = (0, getEventBuffer_1.getEventBuffer)({
+            region,
+            bufferSize,
+            flushSize,
+            flushInterval,
+            credentials,
+            identityId,
+            resendLimit,
+            userAgentValue: (0, utils_1.getAnalyticsUserAgentString)(utils_2.AnalyticsAction.Record),
+        });
+        buffer.append({
+            region,
+            streamName,
+            partitionKey,
+            event: ArrayBuffer.isView(data) ? data : (0, util_utf8_1.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);
+    });
+};
+exports.record = record;

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

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

package/lib/providers/kinesis/index.js

@@ -0,0 +1,8 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flushEvents = exports.record = void 0;
+var apis_1 = require("./apis");
+Object.defineProperty(exports, "record", { enumerable: true, get: function () { return apis_1.record; } });
+Object.defineProperty(exports, "flushEvents", { enumerable: true, get: function () { return apis_1.flushEvents; } });

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

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

package/lib/providers/kinesis/types/index.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/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/providers/kinesis/types/inputs.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/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/providers/kinesis/utils/constants.js

@@ -0,0 +1,11 @@
+"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.DEFAULT_KINESIS_CONFIG = void 0;
+exports.DEFAULT_KINESIS_CONFIG = {
+    bufferSize: 1000,
+    flushSize: 100,
+    flushInterval: 5000,
+    resendLimit: 5,
+};

package/lib/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/providers/kinesis/utils/getEventBuffer.js

@@ -0,0 +1,72 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEventBuffer = void 0;
+const utils_1 = require("../../../utils");
+const client_kinesis_1 = require("@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 client_kinesis_1.PutRecordsCommand({
+    StreamName: streamName,
+    Records: events.map(event => ({
+        PartitionKey: event.partitionKey,
+        Data: event.event,
+    })),
+});
+const submitEvents = async (events, client, resendLimit) => {
+    const groupedByStreamName = Object.entries((0, utils_1.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)
+        : [];
+};
+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 client_kinesis_1.KinesisClient({
+                    credentials,
+                    region,
+                    customUserAgent: userAgentValue,
+                });
+            }
+            return events => submitEvents(events, cachedClients[sessionIdentityKey], resendLimit);
+        };
+        // create new session
+        eventBufferMap[sessionIdentityKey] = new utils_1.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];
+};
+exports.getEventBuffer = getEventBuffer;

package/lib/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/providers/kinesis/utils/resolveConfig.js

@@ -0,0 +1,25 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveConfig = void 0;
+const core_1 = require("@aws-amplify/core");
+const errors_1 = require("../../../errors");
+const constants_1 = require("./constants");
+const resolveConfig = () => {
+    const config = core_1.Amplify.getConfig().Analytics?.Kinesis;
+    const { region, bufferSize = constants_1.DEFAULT_KINESIS_CONFIG.bufferSize, flushSize = constants_1.DEFAULT_KINESIS_CONFIG.flushSize, flushInterval = constants_1.DEFAULT_KINESIS_CONFIG.flushInterval, resendLimit, } = {
+        ...constants_1.DEFAULT_KINESIS_CONFIG,
+        ...config,
+    };
+    (0, errors_1.assertValidationError)(!!region, errors_1.AnalyticsValidationErrorCode.NoRegion);
+    (0, errors_1.assertValidationError)(flushSize < bufferSize, errors_1.AnalyticsValidationErrorCode.InvalidFlushSize);
+    return {
+        region,
+        bufferSize,
+        flushSize,
+        flushInterval,
+        resendLimit,
+    };
+};
+exports.resolveConfig = resolveConfig;

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

@@ -0,0 +1,34 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flushEvents = void 0;
+const utils_1 = require("../utils");
+const utils_2 = require("../../../utils");
+const utils_3 = require("@aws-amplify/core/internals/utils");
+const core_1 = require("@aws-amplify/core");
+const logger = new core_1.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.
+ */
+const flushEvents = () => {
+    const { region, flushSize, flushInterval, bufferSize, resendLimit } = (0, utils_1.resolveConfig)();
+    (0, utils_2.resolveCredentials)()
+        .then(({ credentials, identityId }) => (0, utils_1.getEventBuffer)({
+        region,
+        flushSize,
+        flushInterval,
+        bufferSize,
+        credentials,
+        identityId,
+        resendLimit,
+        userAgentValue: (0, utils_2.getAnalyticsUserAgentString)(utils_3.AnalyticsAction.Record),
+    }))
+        .then(eventBuffer => eventBuffer.flushAll())
+        .catch(e => logger.warn('Failed to flush events.', e));
+};
+exports.flushEvents = flushEvents;

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

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

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

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

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

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