@aws-amplify/analytics/dist/cjs/providers/kinesis/apis/configureAutoTrack.js

Analytics category of aws-amplify

'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.configureAutoTrack = void 0;
const errors_1 = require("../../../errors");
const utils_1 = require("../../../utils");
const record_1 = require("./record");
// Configured Tracker instances for Kinesis
const configuredTrackers = {};
/**
 * Configures automatic event tracking for Kinesis. This API will automatically transmit an analytic event to the
 * configured Kinesis stream when configured events are detected within your application. This can include: DOM
 * element events (via the `event` tracker), session events (via the `session` tracker), and page view events (via
 * the `pageView` tracker).
 *
 * Auto-tracked events are recorded with a data payload of the shape `{ name: eventName, attributes }`.
 *
 * @remark Only session tracking is currently supported on React Native.
 *
 * @param {KinesisConfigureAutoTrackInput} input The input object to configure auto track behavior.
 *
 * @throws validation: {@link AnalyticsValidationErrorCode} - Thrown when the provided parameters or library
 *  configuration is incorrect, or when `streamName` / `partitionKey` are missing while enabling a tracker.
 *
 * @example
 * ```ts
 * // Enable session tracking
 * configureAutoTrack({
 *     enable: true,
 *     type: 'session',
 *     options: {
 *         streamName: 'myKinesisStream',
 *         partitionKey: 'myPartitionKey',
 *     },
 * });
 * ```
 *
 * @example
 * ```ts
 * // Enable page view tracking for a single-page application
 * configureAutoTrack({
 *     enable: true,
 *     type: 'pageView',
 *     options: {
 *         streamName: 'myKinesisStream',
 *         partitionKey: 'myPartitionKey',
 *         appType: 'singlePage',
 *     },
 * });
 * ```
 *
 * @example
 * ```ts
 * // Enable DOM element event tracking
 * configureAutoTrack({
 *     enable: true,
 *     type: 'event',
 *     options: {
 *         streamName: 'myKinesisStream',
 *         partitionKey: 'myPartitionKey',
 *     },
 * });
 * ```
 */
const configureAutoTrack = (input) => {
    (0, utils_1.validateTrackerConfiguration)(input);
    if (input.enable) {
        (0, errors_1.assertValidationError)(!!input.options?.streamName, errors_1.AnalyticsValidationErrorCode.NoStreamName);
        (0, errors_1.assertValidationError)(!!input.options?.partitionKey, errors_1.AnalyticsValidationErrorCode.NoPartitionKey);
    }
    // Callback that will emit an appropriate event to Kinesis when required by the Tracker
    const emitTrackingEvent = (eventName, attributes) => {
        (0, record_1.record)({
            streamName: input.options.streamName,
            partitionKey: input.options.partitionKey,
            data: {
                name: eventName,
                attributes,
            },
        });
    };
    // Initialize or update this provider's trackers. The 'kinesis' namespace keeps
    // page-view tracking state isolated from other providers (e.g. Pinpoint).
    (0, utils_1.updateProviderTrackers)(input, emitTrackingEvent, configuredTrackers, 'kinesis');
};
exports.configureAutoTrack = configureAutoTrack;
//# sourceMappingURL=configureAutoTrack.js.map