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

package/src/types/inputs.ts

@@ -0,0 +1,52 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+import { UserProfile } from '@aws-amplify/core';
+import { AnalyticsServiceOptions } from '.';
+import {
+	SessionTrackingOptions,
+	PageViewTrackingOptions,
+	EventTrackingOptions,
+} from './trackers';
+
+/**
+ * Input type for `identifyUser`.
+ */
+export type AnalyticsIdentifyUserInput<
+	ServiceOptions extends AnalyticsServiceOptions = AnalyticsServiceOptions
+> = {
+	/**
+	 * A User ID associated to the current device.
+	 */
+	userId: string;
+
+	/**
+	 * Additional information about the user and their device.
+	 */
+	userProfile: UserProfile;
+
+	/**
+	 * Options to be passed to the API.
+	 */
+	options?: ServiceOptions;
+};
+
+/**
+ * Input type for `configureAutoTrack`.
+ */
+export type AnalyticsConfigureAutoTrackInput = {
+	enable: boolean;
+} & (
+	| {
+			type: 'session';
+			options?: SessionTrackingOptions;
+	  }
+	| {
+			type: 'pageView';
+			options?: PageViewTrackingOptions;
+	  }
+	| {
+			type: 'event';
+			options?: EventTrackingOptions;
+	  }
+);

package/src/types/kinesis.ts

@@ -0,0 +1,13 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+export type KinesisStream = {
+	region: string;
+	streamName: string;
+};
+
+export type KinesisShard = KinesisStream & {
+	partitionKey: string;
+};
+
+export type KinesisEventData = Record<string, unknown> | Uint8Array;

package/src/types/options.ts

@@ -0,0 +1,7 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+/**
+ * Base type for service options.
+ */
+export type AnalyticsServiceOptions = Record<string, unknown>;

package/src/types/trackers.ts

@@ -0,0 +1,35 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+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/src/utils/eventBuffer/EventBuffer.ts

@@ -0,0 +1,84 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+import { ConsoleLogger } from '@aws-amplify/core';
+import { EventBufferConfig, IAnalyticsClient } from './';
+
+const logger = new ConsoleLogger('EventBuffer');
+
+export class EventBuffer<T> {
+	private list: T[];
+	private readonly config: EventBufferConfig;
+	private getAnalyticsClient: () => IAnalyticsClient<T>;
+
+	private timer?: ReturnType<typeof setInterval>;
+
+	constructor(
+		config: EventBufferConfig,
+		getAnalyticsClient: () => IAnalyticsClient<T>
+	) {
+		this.list = [];
+		this.config = config;
+		this.getAnalyticsClient = getAnalyticsClient;
+		this.startEventLoop();
+	}
+
+	public append(...events: T[]) {
+		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);
+		}
+	}
+
+	public flushAll(): Promise<void> {
+		return this.submitEvents(this.list.length);
+	}
+
+	public release() {
+		this.list = [];
+		if (this.timer) {
+			clearInterval(this.timer);
+		}
+	}
+
+	public get length() {
+		return this.list.length;
+	}
+
+	private head(count: number) {
+		return this.list.splice(0, count);
+	}
+
+	private insertAtBeginning(...data: T[]) {
+		this.list.unshift(...data);
+	}
+
+	private startEventLoop() {
+		if (this.timer) {
+			clearInterval(this.timer);
+		}
+
+		const { flushSize, flushInterval } = this.config;
+		setInterval(() => {
+			this.submitEvents(flushSize);
+		}, flushInterval);
+	}
+
+	private submitEvents(count: number): Promise<void> {
+		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/src/utils/eventBuffer/index.ts

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

package/src/utils/eventBuffer/types.ts

@@ -0,0 +1,12 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+export interface IAnalyticsClient<T> {
+	(events: T[]): Promise<T[]>;
+}
+
+export type EventBufferConfig = {
+	flushSize: number;
+	flushInterval: number;
+	bufferSize: number;
+};

package/src/utils/groupBy.ts

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

package/src/utils/index.ts

@@ -0,0 +1,21 @@
+// 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,
+	IAnalyticsClient,
+	EventBufferConfig,
+} from './eventBuffer';
+export {
+	enableAnalytics,
+	disableAnalytics,
+	isAnalyticsEnabled,
+} from './statusHelpers';
+export {
+	getAnalyticsUserAgent,
+	getAnalyticsUserAgentString,
+} from './userAgent';
+export { updateProviderTrackers } from './trackerHelpers';
+export { validateTrackerConfiguration } from './trackerConfigHelpers';

package/src/utils/resolveCredentials.ts

@@ -0,0 +1,14 @@
+// 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/src/utils/statusHelpers.ts

@@ -0,0 +1,17 @@
+// 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/src/utils/trackerConfigHelpers.native.ts

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

package/src/utils/trackerConfigHelpers.ts

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

package/src/utils/trackerHelpers.ts

@@ -0,0 +1,57 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+import {
+	TrackerAttributes,
+	TrackerEventRecorder,
+	TrackerInterface,
+	TrackerType,
+} from '../types/trackers';
+import { EventTracker, PageViewTracker, SessionTracker } from '../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 const updateProviderTrackers = (
+	input: ConfigureAutoTrackInput,
+	providerEventRecorder: TrackerEventRecorder,
+	providerTrackers: Partial<Record<TrackerType, TrackerInterface>>
+) => {
+	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/src/utils/{UserAgent.ts → userAgent.ts}

@@ -5,7 +5,7 @@ import {
 	Category,
 	getAmplifyUserAgentObject,
 	getAmplifyUserAgent,
-} from '@aws-amplify/core';
+} from '@aws-amplify/core/internals/utils';
 import { UserAgent } from '@aws-sdk/types';
 
 export function getAnalyticsUserAgent(action: AnalyticsAction): UserAgent {

package/lib/.tsbuildinfo

@@ -1,3 +0,0 @@
-{
-  "version": "3.8.3"
-}

package/lib/Analytics.d.ts

@@ -1,87 +0,0 @@
-import { AnalyticsProvider, AnalyticsEvent, AutoTrackSessionOpts, AutoTrackPageViewOpts, AutoTrackEventOpts, PersonalizeAnalyticsEvent, KinesisAnalyticsEvent } from './types';
-import { PageViewTracker, EventTracker, SessionTracker } from './trackers';
-declare const trackers: {
-    pageView: typeof PageViewTracker;
-    event: typeof EventTracker;
-    session: typeof SessionTracker;
-};
-declare type TrackerTypes = keyof typeof trackers;
-/**
- * Provide mobile analytics client functions
- */
-export declare class AnalyticsClass {
-    private _config;
-    private _pluggables;
-    private _disabled;
-    private _trackers;
-    /**
-     * Initialize Analtyics
-     * @param config - Configuration of the Analytics
-     */
-    constructor();
-    getModuleName(): string;
-    /**
-     * configure Analytics
-     * @param {Object} config - Configuration of the Analytics
-     */
-    configure(config?: any): any;
-    /**
-     * add plugin into Analytics category
-     * @param pluggable - an instance of the plugin
-     */
-    addPluggable(pluggable: AnalyticsProvider): any;
-    /**
-     * Get the plugin object
-     * @param providerName - the name of the provider to be removed
-     */
-    getPluggable(providerName: string): AnalyticsProvider;
-    /**
-     * Remove the plugin object
-     * @param providerName - the name of the provider to be removed
-     */
-    removePluggable(providerName: string): void;
-    /**
-     * stop sending events
-     */
-    disable(): void;
-    /**
-     * start sending events
-     */
-    enable(): void;
-    /**
-     * Record Session start
-     * @param [provider] - name of the provider.
-     * @return - A promise which resolves if buffer doesn't overflow
-     */
-    startSession(provider?: string): Promise<unknown>;
-    /**
-     * Record Session stop
-     * @param [provider] - name of the provider.
-     * @return - A promise which resolves if buffer doesn't overflow
-     */
-    stopSession(provider?: string): Promise<unknown>;
-    /**
-     * Record one analytic event and send it to Pinpoint
-     * @param event - An object with the name of the event, attributes of the event and event metrics.
-     * @param [provider] - name of the provider.
-     */
-    record(event: AnalyticsEvent | PersonalizeAnalyticsEvent | KinesisAnalyticsEvent, provider?: string): Promise<unknown>;
-    updateEndpoint(attrs: {
-        [key: string]: any;
-    }, provider?: string): Promise<unknown>;
-    private _sendEvent;
-    /**
-     * Enable or disable auto tracking
-     * @param trackerType - The type of tracker to activate.
-     * @param [opts] - Auto tracking options.
-     */
-    autoTrack(trackerType: 'session', opts: AutoTrackSessionOpts): any;
-    autoTrack(trackerType: 'pageView', opts: AutoTrackPageViewOpts): any;
-    autoTrack(trackerType: 'event', opts: AutoTrackEventOpts): any;
-    autoTrack(trackerType: TrackerTypes, opts: {
-        provider: string;
-        [key: string]: any;
-    }): any;
-}
-export declare const Analytics: AnalyticsClass;
-export {};