@aws-amplify/analytics 7.0.1-console-preview.f63250a.0 → 7.0.1-console-preview.e8aa063.0

package/lib-esm/vendor/dom-utils/matches.js

@@ -1,65 +0,0 @@
-/**
- * Copyright (c) 2017, Philip Walton <philip@philipwalton.com>
- */
-import { browserOrNode } from '@aws-amplify/core';
-var proto = browserOrNode().isBrowser && window['Element']
-    ? window['Element'].prototype
-    : null;
-var nativeMatches = proto
-    ? proto.matches ||
-        // @ts-ignore
-        proto.matchesSelector ||
-        // @ts-ignore
-        proto.webkitMatchesSelector ||
-        // @ts-ignore
-        proto.mozMatchesSelector ||
-        // @ts-ignore
-        proto.msMatchesSelector ||
-        // @ts-ignore
-        proto.oMatchesSelector
-    : null;
-/**
- * Tests if a DOM elements matches any of the test DOM elements or selectors.
- * @param {Element} element The DOM element to test.
- * @param {Element|string|Array<Element|string>} test A DOM element, a CSS
- *     selector, or an array of DOM elements or CSS selectors to match against.
- * @return {boolean} True of any part of the test matches.
- */
-export function matches(element, test) {
-    // Validate input.
-    if (element && element.nodeType === 1 && test) {
-        // if test is a string or DOM element test it.
-        if (typeof test === 'string' || test.nodeType === 1) {
-            return (element === test || matchesSelector(element, /** @type {string} */ test));
-        }
-        else if ('length' in test) {
-            // if it has a length property iterate over the items
-            // and return true if any match.
-            for (var i = 0, item = void 0; (item = test[i]); i++) {
-                if (element === item || matchesSelector(element, item))
-                    return true;
-            }
-        }
-    }
-    // Still here? Return false
-    return false;
-}
-/**
- * Tests whether a DOM element matches a selector. This polyfills the native
- * Element.prototype.matches method across browsers.
- * @param {!Element} element The DOM element to test.
- * @param {string} selector The CSS selector to test element against.
- * @return {boolean} True if the selector matches.
- */
-function matchesSelector(element, selector) {
-    if (typeof selector !== 'string')
-        return false;
-    if (nativeMatches)
-        return nativeMatches.call(element, selector);
-    var nodes = element.parentNode.querySelectorAll(selector);
-    for (var i = 0, node = void 0; (node = nodes[i]); i++) {
-        if (node === element)
-            return true;
-    }
-    return false;
-}

package/lib-esm/vendor/dom-utils/parents.d.ts

@@ -1,10 +0,0 @@
-/**
- * Copyright (c) 2017, Philip Walton <philip@philipwalton.com>
- */
-/**
- * Returns an array of a DOM element's parent elements.
- * @param {!Element} element The DOM element whose parents to get.
- * @return {!Array} An array of all parent elemets, or an empty array if no
- *     parent elements are found.
- */
-export declare function parents(ele: any): any[];

package/lib-esm/vendor/dom-utils/parents.js

@@ -1,18 +0,0 @@
-/**
- * Copyright (c) 2017, Philip Walton <philip@philipwalton.com>
- */
-/**
- * Returns an array of a DOM element's parent elements.
- * @param {!Element} element The DOM element whose parents to get.
- * @return {!Array} An array of all parent elemets, or an empty array if no
- *     parent elements are found.
- */
-export function parents(ele) {
-    var list = [];
-    var element = ele;
-    while (element && element.parentNode && element.parentNode.nodeType === 1) {
-        element = /** @type {!Element} */ element.parentNode;
-        list.push(element);
-    }
-    return list;
-}

package/lib-esm/vendor/dom-utils/parse-url.d.ts

@@ -1,9 +0,0 @@
-/**
- * Copyright (c) 2017, Philip Walton <philip@philipwalton.com>
- */
-/**
- * Parses the given url and returns an object mimicing a `Location` object.
- * @param {string} url The url to parse.
- * @return {!Object} An object with the same properties as a `Location`.
- */
-export declare function parseUrl(u: any): any;

package/lib-esm/vendor/dom-utils/parse-url.js

@@ -1,55 +0,0 @@
-/**
- * Copyright (c) 2017, Philip Walton <philip@philipwalton.com>
- */
-import { browserOrNode } from '@aws-amplify/core';
-var HTTP_PORT = '80';
-var HTTPS_PORT = '443';
-var DEFAULT_PORT = RegExp(':(' + HTTP_PORT + '|' + HTTPS_PORT + ')$');
-var a = browserOrNode().isBrowser ? document.createElement('a') : null;
-var cache = {};
-/**
- * Parses the given url and returns an object mimicing a `Location` object.
- * @param {string} url The url to parse.
- * @return {!Object} An object with the same properties as a `Location`.
- */
-export function parseUrl(u) {
-    var url = u;
-    // All falsy values (as well as ".") should map to the current URL.
-    url = !url || url === '.' ? location.href : url;
-    if (cache[url])
-        return cache[url];
-    a.href = url;
-    // When parsing file relative paths (e.g. `../index.html`), IE will correctly
-    // resolve the `href` property but will keep the `..` in the `path` property.
-    // It will also not include the `host` or `hostname` properties. Furthermore,
-    // IE will sometimes return no protocol or just a colon, especially for things
-    // like relative protocol URLs (e.g. "//google.com").
-    // To workaround all of these issues, we reparse with the full URL from the
-    // `href` property.
-    if (url.charAt(0) === '.' || url.charAt(0) === '/')
-        return parseUrl(a.href);
-    // Don't include default ports.
-    var port = a.port === HTTP_PORT || a.port === HTTPS_PORT ? '' : a.port;
-    // PhantomJS sets the port to "0" when using the file: protocol.
-    port = port === '0' ? '' : port;
-    // Sometimes IE incorrectly includes a port for default ports
-    // (e.g. `:80` or `:443`) even when no port is specified in the URL.
-    // http://bit.ly/1rQNoMg
-    var host = a.host.replace(DEFAULT_PORT, '');
-    // Not all browser support `origin` so we have to build it.
-    var origin = a['origin'] ? a['origin'] : a.protocol + '//' + host;
-    // Sometimes IE doesn't include the leading slash for pathname.
-    // http://bit.ly/1rQNoMg
-    var pathname = a.pathname.charAt(0) === '/' ? a.pathname : '/' + a.pathname;
-    return (cache[url] = {
-        hash: a.hash,
-        host: host,
-        hostname: a.hostname,
-        href: a.href,
-        origin: origin,
-        pathname: pathname,
-        port: port,
-        protocol: a.protocol,
-        search: a.search,
-    });
-}

package/src/Analytics.ts

@@ -1,446 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-
-import {
-	Amplify,
-	ConsoleLogger as Logger,
-	Hub,
-	parseAWSExports,
-} from '@aws-amplify/core';
-import { AWSPinpointProvider } from './providers/AWSPinpointProvider';
-
-import {
-	AnalyticsProvider,
-	EventAttributes,
-	EventMetrics,
-	AnalyticsEvent,
-	AutoTrackSessionOpts,
-	AutoTrackPageViewOpts,
-	AutoTrackEventOpts,
-	PersonalizeAnalyticsEvent,
-	KinesisAnalyticsEvent,
-} from './types';
-import { PageViewTracker, EventTracker, SessionTracker } from './trackers';
-
-const logger = new Logger('AnalyticsClass');
-
-const AMPLIFY_SYMBOL = (
-	typeof Symbol !== 'undefined' && typeof Symbol.for === 'function'
-		? Symbol.for('amplify_default')
-		: '@@amplify_default'
-) as Symbol;
-
-const dispatchAnalyticsEvent = (event: string, data: any, message: string) => {
-	Hub.dispatch(
-		'analytics',
-		{ event, data, message },
-		'Analytics',
-		AMPLIFY_SYMBOL
-	);
-};
-
-const trackers = {
-	pageView: PageViewTracker,
-	event: EventTracker,
-	session: SessionTracker,
-};
-
-type TrackerTypes = keyof typeof trackers;
-type Trackers = (typeof trackers)[TrackerTypes];
-let _instance = null;
-
-/**
- * Provide mobile analytics client functions
- */
-export class AnalyticsClass {
-	private _config;
-	private _pluggables: AnalyticsProvider[];
-	private _disabled: boolean;
-	private _trackers: Trackers | {};
-
-	/**
-	 * Initialize Analtyics
-	 * @param config - Configuration of the Analytics
-	 */
-	constructor() {
-		this._config = {};
-		this._pluggables = [];
-		this._disabled = false;
-		this._trackers = {};
-		_instance = this;
-
-		this.record = this.record.bind(this);
-		Hub.listen('auth', listener);
-		Hub.listen('storage', listener);
-		Hub.listen('analytics', listener);
-		Hub.listen('core', listener);
-	}
-
-	public getModuleName() {
-		return 'Analytics';
-	}
-	/**
-	 * configure Analytics
-	 * @param {Object} config - Configuration of the Analytics
-	 */
-	public configure(config?) {
-		if (!config) return this._config;
-		logger.debug('configure Analytics', config);
-		const amplifyConfig = parseAWSExports(config);
-		this._config = Object.assign(
-			{},
-			this._config,
-			amplifyConfig.Analytics,
-			config
-		);
-
-		if (this._config['disabled']) {
-			this._disabled = true;
-		}
-
-		// turn on the autoSessionRecord if not specified
-		if (this._config['autoSessionRecord'] === undefined) {
-			this._config['autoSessionRecord'] = true;
-		}
-
-		this._pluggables.forEach(pluggable => {
-			// for backward compatibility
-			const providerConfig =
-				pluggable.getProviderName() === 'AWSPinpoint' &&
-				!this._config['AWSPinpoint']
-					? this._config
-					: this._config[pluggable.getProviderName()];
-
-			pluggable.configure({
-				disabled: this._config['disabled'],
-				autoSessionRecord: this._config['autoSessionRecord'],
-				...providerConfig,
-			});
-		});
-
-		if (this._pluggables.length === 0) {
-			this.addPluggable(new AWSPinpointProvider());
-		}
-
-		dispatchAnalyticsEvent(
-			'configured',
-			null,
-			`The Analytics category has been configured successfully`
-		);
-		logger.debug('current configuration', this._config);
-		return this._config;
-	}
-
-	/**
-	 * add plugin into Analytics category
-	 * @param pluggable - an instance of the plugin
-	 */
-	public addPluggable(pluggable: AnalyticsProvider) {
-		if (pluggable && pluggable.getCategory() === 'Analytics') {
-			this._pluggables.push(pluggable);
-			// for backward compatibility
-			const providerConfig =
-				pluggable.getProviderName() === 'AWSPinpoint' &&
-				!this._config['AWSPinpoint']
-					? this._config
-					: this._config[pluggable.getProviderName()];
-			const config = { disabled: this._config['disabled'], ...providerConfig };
-			pluggable.configure(config);
-			return config;
-		}
-	}
-
-	/**
-	 * Get the plugin object
-	 * @param providerName - the name of the provider to be removed
-	 */
-	public getPluggable(providerName: string): AnalyticsProvider {
-		for (let i = 0; i < this._pluggables.length; i += 1) {
-			const pluggable = this._pluggables[i];
-			if (pluggable.getProviderName() === providerName) {
-				return pluggable;
-			}
-		}
-
-		logger.debug('No plugin found with providerName', providerName);
-		return null;
-	}
-
-	/**
-	 * Remove the plugin object
-	 * @param providerName - the name of the provider to be removed
-	 */
-	public removePluggable(providerName: string): void {
-		let idx = 0;
-		while (idx < this._pluggables.length) {
-			if (this._pluggables[idx].getProviderName() === providerName) {
-				break;
-			}
-			idx += 1;
-		}
-
-		if (idx === this._pluggables.length) {
-			logger.debug('No plugin found with providerName', providerName);
-			return;
-		} else {
-			this._pluggables.splice(idx, idx + 1);
-			return;
-		}
-	}
-
-	/**
-	 * stop sending events
-	 */
-	public disable() {
-		this._disabled = true;
-	}
-
-	/**
-	 * start sending events
-	 */
-	public enable() {
-		this._disabled = false;
-	}
-
-	/**
-	 * Record Session start
-	 * @param [provider] - name of the provider.
-	 * @return - A promise which resolves if buffer doesn't overflow
-	 */
-	public async startSession(provider?: string) {
-		const event = { name: '_session.start' };
-		const params = { event, provider };
-
-		dispatchAnalyticsEvent(
-			'record',
-			event,
-			'Recording Analytics session start event'
-		);
-
-		return this._sendEvent(params);
-	}
-
-	/**
-	 * Record Session stop
-	 * @param [provider] - name of the provider.
-	 * @return - A promise which resolves if buffer doesn't overflow
-	 */
-	public async stopSession(provider?: string) {
-		const event = { name: '_session.stop' };
-		const params = { event, provider };
-
-		dispatchAnalyticsEvent(
-			'record',
-			event,
-			'Recording Analytics session stop event'
-		);
-
-		return this._sendEvent(params);
-	}
-
-	/**
-	 * 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.
-	 */
-	public async record(
-		event: AnalyticsEvent | PersonalizeAnalyticsEvent | KinesisAnalyticsEvent,
-		provider?: string
-	) {
-		const params = { event, provider };
-
-		dispatchAnalyticsEvent('record', params.event, 'Recording Analytics event');
-
-		return this._sendEvent(params);
-	}
-
-	public async updateEndpoint(
-		attrs: { [key: string]: any },
-		provider?: string
-	) {
-		const event = { ...attrs, name: '_update_endpoint' };
-
-		return this.record(event, provider);
-	}
-
-	private _sendEvent(params: {
-		event: AnalyticsEvent | PersonalizeAnalyticsEvent | KinesisAnalyticsEvent;
-		provider?: string;
-	}) {
-		if (this._disabled) {
-			logger.debug('Analytics has been disabled');
-			return Promise.resolve();
-		}
-
-		const provider = params.provider ? params.provider : 'AWSPinpoint';
-		return new Promise((resolve, reject) => {
-			this._pluggables.forEach(pluggable => {
-				if (pluggable.getProviderName() === provider) {
-					pluggable.record(params, { resolve, reject });
-				}
-			});
-		});
-	}
-
-	/**
-	 * Enable or disable auto tracking
-	 * @param trackerType - The type of tracker to activate.
-	 * @param [opts] - Auto tracking options.
-	 */
-	public autoTrack(trackerType: 'session', opts: AutoTrackSessionOpts);
-	public autoTrack(trackerType: 'pageView', opts: AutoTrackPageViewOpts);
-	public autoTrack(trackerType: 'event', opts: AutoTrackEventOpts);
-	// ensures backwards compatibility for non-pinpoint provider users
-	public autoTrack(
-		trackerType: TrackerTypes,
-		opts: { provider: string; [key: string]: any }
-	);
-	public autoTrack(trackerType: TrackerTypes, opts: { [key: string]: any }) {
-		if (!trackers[trackerType]) {
-			logger.debug('invalid tracker type');
-			return;
-		}
-
-		// to sync up two different configuration ways of auto session tracking
-		if (trackerType === 'session') {
-			this._config['autoSessionRecord'] = opts['enable'];
-		}
-
-		const tracker = this._trackers[trackerType];
-		if (!tracker) {
-			this._trackers[trackerType] = new trackers[trackerType](
-				this.record,
-				opts
-			);
-		} else {
-			tracker.configure(opts);
-		}
-	}
-}
-
-let endpointUpdated = false;
-let authConfigured = false;
-let analyticsConfigured = false;
-let credentialsConfigured = false;
-
-const listener = capsule => {
-	const { channel, payload } = capsule;
-	logger.debug('on hub capsule ' + channel, payload);
-
-	switch (channel) {
-		case 'auth':
-			authEvent(payload);
-			break;
-		case 'storage':
-			storageEvent(payload);
-			break;
-		case 'analytics':
-			analyticsEvent(payload);
-			break;
-		case 'core':
-			coreEvent(payload);
-			break;
-		default:
-			break;
-	}
-};
-
-const storageEvent = payload => {
-	const {
-		data: { attrs, metrics },
-	} = payload;
-	if (!attrs) return;
-
-	if (analyticsConfigured) {
-		_instance
-			.record({
-				name: 'Storage',
-				attributes: attrs,
-				metrics,
-			})
-			.catch(e => {
-				logger.debug('Failed to send the storage event automatically', e);
-			});
-	}
-};
-
-const authEvent = payload => {
-	const { event } = payload;
-	if (!event) {
-		return;
-	}
-
-	const recordAuthEvent = async eventName => {
-		if (authConfigured && analyticsConfigured) {
-			try {
-				return await _instance.record({ name: `_userauth.${eventName}` });
-			} catch (err) {
-				logger.debug(
-					`Failed to send the ${eventName} event automatically`,
-					err
-				);
-			}
-		}
-	};
-
-	switch (event) {
-		case 'signIn':
-			return recordAuthEvent('sign_in');
-		case 'signUp':
-			return recordAuthEvent('sign_up');
-		case 'signOut':
-			return recordAuthEvent('sign_out');
-		case 'signIn_failure':
-			return recordAuthEvent('auth_fail');
-		case 'configured':
-			authConfigured = true;
-			if (analyticsConfigured) {
-				sendEvents();
-			}
-			break;
-	}
-};
-
-const analyticsEvent = payload => {
-	const { event } = payload;
-	if (!event) return;
-
-	switch (event) {
-		case 'pinpointProvider_configured':
-			analyticsConfigured = true;
-			if (authConfigured || credentialsConfigured) {
-				sendEvents();
-			}
-			break;
-	}
-};
-
-const coreEvent = payload => {
-	const { event } = payload;
-	if (!event) return;
-
-	switch (event) {
-		case 'credentials_configured':
-			credentialsConfigured = true;
-			if (analyticsConfigured) {
-				sendEvents();
-			}
-			break;
-	}
-};
-
-const sendEvents = () => {
-	const config = _instance.configure();
-	if (!endpointUpdated && config['autoSessionRecord']) {
-		_instance.updateEndpoint({ immediate: true }).catch(e => {
-			logger.debug('Failed to update the endpoint', e);
-		});
-		endpointUpdated = true;
-	}
-	_instance.autoTrack('session', {
-		enable: config['autoSessionRecord'],
-	});
-};
-
-export const Analytics = new AnalyticsClass();
-Amplify.register(Analytics);

package/src/providers/AWSKinesisFirehoseProvider.ts

@@ -1,105 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-
-import { AnalyticsAction, ConsoleLogger as Logger } from '@aws-amplify/core';
-import { AWSKinesisProvider } from './AWSKinesisProvider';
-import {
-	PutRecordBatchCommand,
-	FirehoseClient,
-} from '@aws-sdk/client-firehose';
-import { fromUtf8 } from '@aws-sdk/util-utf8-browser';
-import { getAnalyticsUserAgent } from '../utils/UserAgent';
-
-const logger = new Logger('AWSKineisFirehoseProvider');
-
-export class AWSKinesisFirehoseProvider extends AWSKinesisProvider {
-	private _kinesisFirehose: FirehoseClient;
-
-	constructor(config?) {
-		super(config);
-	}
-
-	/**
-	 * get provider name of the plugin
-	 */
-	public getProviderName(): string {
-		return 'AWSKinesisFirehose';
-	}
-
-	protected _sendEvents(group) {
-		if (group.length === 0) {
-			return;
-		}
-
-		const { config, credentials } = group[0];
-
-		const initClients = this._init(config, credentials);
-		if (!initClients) return false;
-
-		const records = {};
-
-		group.map(params => {
-			// split by streamName
-			const evt = params.event;
-			const { streamName, data } = evt;
-			if (records[streamName] === undefined) {
-				records[streamName] = [];
-			}
-
-			const bufferData =
-				data && typeof data !== 'string' ? JSON.stringify(data) : data;
-			const Data = fromUtf8(bufferData);
-			const record = { Data };
-			records[streamName].push(record);
-		});
-
-		Object.keys(records).map(streamName => {
-			logger.debug(
-				'putting records to kinesis',
-				streamName,
-				'with records',
-				records[streamName]
-			);
-
-			this._kinesisFirehose
-				.send(
-					new PutRecordBatchCommand({
-						Records: records[streamName],
-						DeliveryStreamName: streamName,
-					})
-				)
-				.then(res => logger.debug('Upload records to stream', streamName))
-				.catch(err => logger.debug('Failed to upload records to Kinesis', err));
-		});
-	}
-
-	protected _init(config, credentials) {
-		logger.debug('init clients');
-
-		if (
-			this._kinesisFirehose &&
-			this._config.credentials &&
-			this._config.credentials.sessionToken === credentials.sessionToken &&
-			this._config.credentials.identityId === credentials.identityId
-		) {
-			logger.debug('no change for analytics config, directly return from init');
-			return true;
-		}
-
-		this._config.credentials = credentials;
-		const { region } = config;
-
-		return this._initFirehose(region, credentials);
-	}
-
-	private _initFirehose(region, credentials) {
-		logger.debug('initialize kinesis firehose with credentials', credentials);
-		this._kinesisFirehose = new FirehoseClient({
-			apiVersion: '2015-08-04',
-			region,
-			credentials,
-			customUserAgent: getAnalyticsUserAgent(AnalyticsAction.Record),
-		});
-		return true;
-	}
-}