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

package/src/trackers/SessionTracker-rn.ts

@@ -1,134 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-
-// the session tracker for react native
-
-import { ConsoleLogger as Logger } from '@aws-amplify/core';
-import { SessionTrackOpts } from '../types';
-import { AppState } from 'react-native';
-
-const logger = new Logger('SessionTracker');
-
-const defaultOpts: SessionTrackOpts = {
-	enable: false,
-	provider: 'AWSPinpoint',
-};
-
-let initialEventSent = false;
-
-export class SessionTracker {
-	private _tracker;
-	private _hasEnabled;
-	private _config: SessionTrackOpts;
-	private _currentState;
-
-	constructor(tracker, opts) {
-		this._config = Object.assign({}, defaultOpts, opts);
-		this._tracker = tracker;
-
-		this._hasEnabled = false;
-		this._trackFunc = this._trackFunc.bind(this);
-		this._currentState = AppState.currentState;
-		this.configure(this._config);
-	}
-
-	private _envCheck() {
-		if (!AppState) {
-			logger.debug('not in the supported react native environment');
-			return false;
-		}
-		return true;
-	}
-
-	private async _trackFunc(nextAppState) {
-		const customAttrs =
-			typeof this._config.attributes === 'function'
-				? await this._config.attributes()
-				: this._config.attributes;
-		const attributes = Object.assign({}, customAttrs);
-
-		if (
-			this._currentState.match(/inactive|background/) &&
-			nextAppState === 'active'
-		) {
-			logger.debug('App has come to the foreground, recording start session');
-			this._tracker(
-				{
-					name: '_session.start',
-					attributes,
-					immediate: false,
-				},
-				this._config.provider
-			).catch(e => {
-				logger.debug('record session start event failed.', e);
-			});
-		}
-		if (
-			this._currentState.match(/active/) &&
-			nextAppState.match(/inactive|background/)
-		) {
-			logger.debug(
-				'App has come to inactive/background, recording stop session'
-			);
-			this._tracker(
-				{
-					name: '_session.stop',
-					attributes,
-					immediate: false,
-				},
-				this._config.provider
-			).catch(e => {
-				logger.debug('record session stop event failed.', e);
-			});
-		}
-
-		this._currentState = nextAppState;
-	}
-
-	// to keep configure a synchronized function
-	private async _sendInitialEvent() {
-		if (initialEventSent) {
-			logger.debug('the start session has been sent when the page is loaded');
-			return;
-		} else {
-			initialEventSent = true;
-		}
-
-		const customAttrs =
-			typeof this._config.attributes === 'function'
-				? await this._config.attributes()
-				: this._config.attributes;
-		const attributes = Object.assign({}, customAttrs);
-
-		this._tracker(
-			{
-				name: '_session.start',
-				attributes,
-				immediate: false,
-			},
-			this._config.provider
-		).catch(e => {
-			logger.debug('record session start event failed.', e);
-		});
-	}
-
-	configure(opts?: SessionTrackOpts) {
-		if (!this._envCheck()) {
-			return this._config;
-		}
-
-		Object.assign(this._config, opts);
-		if (this._config.enable && !this._hasEnabled) {
-			// send a start session as soon as it's enabled
-			this._sendInitialEvent();
-			// listen on events
-			AppState.addEventListener('change', this._trackFunc, false);
-			this._hasEnabled = true;
-		} else if (!this._config.enable && this._hasEnabled) {
-			AppState.removeEventListener('change', this._trackFunc, false);
-			this._hasEnabled = false;
-		}
-
-		return this._config;
-	}
-}

package/src/trackers/reactnative.ts

@@ -1,13 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { SessionTracker } from './SessionTracker-rn';
-
-class EventTracker {
-	constructor(tracker, opts) {}
-}
-
-class PageViewTracker {
-	constructor(tracker, opts) {}
-}
-
-export { EventTracker, PageViewTracker, SessionTracker };

package/src/types/Analytics.ts

@@ -1,87 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { ICredentials } from '@aws-amplify/core';
-/**
- * Analytics instance options
- */
-export interface AnalyticsOptions {
-	appId: string;
-	platform?: string;
-	clientId?: string;
-	region?: string;
-	credentials?: ICredentials;
-}
-
-export interface EventAttributes {
-	[key: string]: string;
-}
-
-export interface EventMetrics {
-	[key: string]: number;
-}
-
-export interface pageViewTrackOpts {
-	enable: boolean;
-	type?: string;
-	eventName?: string;
-	provider?: string;
-	attributes?:
-		| EventAttributes
-		| (() => EventAttributes | Promise<EventAttributes>);
-	getUrl?: () => string;
-}
-
-export interface EventTrackOpts {
-	enable: boolean;
-	events?: Array<string>;
-	selectorPrefix?: string;
-	provider?: string;
-	attributes?:
-		| EventAttributes
-		| (() => EventAttributes | Promise<EventAttributes>);
-}
-
-export interface SessionTrackOpts {
-	enable: boolean;
-	attributes?:
-		| EventAttributes
-		| (() => EventAttributes | Promise<EventAttributes>);
-	provider?: string;
-}
-
-export type AutoTrackAttributes =
-	| (() => EventAttributes | Promise<EventAttributes>)
-	| EventAttributes;
-
-export interface AutoTrackSessionOpts {
-	enable: boolean;
-	attributes?: AutoTrackAttributes;
-	provider?: string;
-}
-
-export interface AutoTrackPageViewOpts {
-	enable: boolean;
-	eventName?: string;
-	attributes?: AutoTrackAttributes;
-	type?: 'SPA' | 'multiPageApp';
-	provider?: string;
-	getUrl?: () => string;
-}
-
-export interface AutoTrackEventOpts {
-	enable: boolean;
-	events?: string[];
-	selectorPrefix?: string;
-	provider?: string;
-	attributes?: AutoTrackAttributes;
-}
-
-export interface AnalyticsEvent {
-	name: string;
-	attributes?: EventAttributes;
-	metrics?: EventMetrics;
-	immediate?: boolean;
-}
-
-export { PersonalizeAnalyticsEvent } from './Providers/AmazonPersonalizeProvider';
-export { KinesisAnalyticsEvent } from './Providers/AWSKinesisProvider';

package/src/types/Provider.ts

@@ -1,26 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-
-export interface PromiseHandlers {
-	resolve: Function;
-	reject: Function;
-}
-
-// CAUTION: The AnalyticsProvider interface is publicly available and allows customers to implement their own custom
-// analytics providers. Exercise caution when modifying this class as additive changes to this interface can break
-// customers when not marked as optional.
-export interface AnalyticsProvider {
-	// you need to implement those methods
-
-	// configure your provider
-	configure(config: object): object;
-
-	// record events and returns true if succeeds
-	record(params: object, handlers?: PromiseHandlers): Promise<boolean>;
-
-	// return 'Analytics';
-	getCategory(): string;
-
-	// return the name of you provider
-	getProviderName(): string;
-}

package/src/types/Providers/AWSPinpointProvider.ts

@@ -1,60 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { PromiseHandlers } from '../Provider';
-
-export type Event = {
-	eventId: string;
-	name: string;
-	attributes: string;
-	metrics: string;
-	session: object;
-	immediate: boolean;
-};
-
-export type EventConfig = {
-	appId: string;
-	endpointId: string;
-	region: string;
-	resendLimit: number;
-};
-
-export type EventParams = {
-	event: Event;
-	timestamp: string;
-	config: EventConfig;
-	credentials: object;
-	resendLimit: number;
-};
-
-export type EventObject = {
-	params: EventParams;
-	handlers: PromiseHandlers;
-};
-
-export type EventMap = {
-	[key: string]: EventObject;
-};
-
-export type EventBuffer = Array<EventMap>;
-export type EndpointBuffer = Array<EventObject>;
-
-export type PutEventsResponse = {
-	EventsResponse: {
-		Results?: {
-			[endpointId: string]: {
-				EventsItemResponse?: {
-					[eventId: string]: {
-						StatusCode?: number;
-						Message?: string;
-					};
-				};
-			};
-		};
-	};
-};
-
-export type EndpointFailureData = {
-	err: any;
-	update_params: any;
-	endpointObject: EventObject;
-};

package/src/types/Providers/AmazonPersonalizeProvider.ts

@@ -1,9 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-export interface PersonalizeAnalyticsEvent {
-	eventType?: string;
-	userId?: string;
-	properties?: {
-		[key: string]: string;
-	};
-}

package/src/utils/AppUtils.native.ts

@@ -1,9 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { AppState } from 'react-native';
-
-const isAppInForeground = () => {
-	return AppState.currentState === 'active';
-};
-
-export { isAppInForeground };

package/src/utils/MethodEmbed.ts

@@ -1,49 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-
-const lists: MethodEmbed[] = [];
-
-export class MethodEmbed {
-	public context;
-	public methodName;
-	private _originalMethod;
-	private _bindedMethod;
-
-	static add(context, methodName, methodOverride) {
-		getInstance(context, methodName).set(methodOverride);
-	}
-
-	static remove(context, methodName) {
-		getInstance(context, methodName).remove();
-	}
-
-	constructor(context, methodName) {
-		this.context = context;
-		this.methodName = methodName;
-
-		this._originalMethod = context[methodName].bind(context);
-	}
-
-	public set(methodOverride) {
-		this.context[this.methodName] = (...args) => {
-			return methodOverride(this._originalMethod(...args));
-		};
-	}
-
-	public remove() {
-		this.context[this.methodName] = this._originalMethod;
-	}
-}
-
-function getInstance(context, methodName): MethodEmbed {
-	let instance = lists.filter(
-		h => h.context === context && h.methodName === methodName
-	)[0];
-
-	if (!instance) {
-		instance = new MethodEmbed(context, methodName);
-		lists.push(instance);
-	}
-
-	return instance;
-}

package/src/vendor/dom-utils/closest.ts

@@ -1,25 +0,0 @@
-/**
- * Copyright (c) 2017, Philip Walton <philip@philipwalton.com>
- */
-
-import { matches } from './matches';
-import { parents } from './parents';
-
-/**
- * Gets the closest parent element that matches the passed selector.
- * @param {Element} element The element whose parents to check.
- * @param {string} selector The CSS selector to match against.
- * @param {boolean=} shouldCheckSelf True if the selector should test against
- *     the passed element itself.
- * @return {Element|undefined} The matching element or undefined.
- */
-export function closest(element, selector, shouldCheckSelf = false) {
-	if (!(element && element.nodeType === 1 && selector)) return;
-	const parentElements = (shouldCheckSelf ? [element] : []).concat(
-		parents(element)
-	);
-
-	for (let i = 0, parent; (parent = parentElements[i]); i++) {
-		if (matches(parent, selector)) return parent;
-	}
-}

package/src/vendor/dom-utils/delegate.ts

@@ -1,51 +0,0 @@
-/**
- * Copyright (c) 2017, Philip Walton <philip@philipwalton.com>
- */
-
-import { closest } from './closest';
-import { matches } from './matches';
-
-/**
- * Delegates the handling of events for an element matching a selector to an
- * ancestor of the matching element.
- * @param {!Node} ancestor The ancestor element to add the listener to.
- * @param {string} eventType The event type to listen to.
- * @param {string} selector A CSS selector to match against child elements.
- * @param {!Function} callback A function to run any time the event happens.
- * @param {Object=} opts A configuration options object. The available options:
- *     - useCapture<boolean>: If true, bind to the event capture phase.
- *     - deep<boolean>: If true, delegate into shadow trees.
- * @return {Object} The delegate object. It contains a destroy method.
- */
-export function delegate(ancestor, eventType, selector, callback, opts = {}) {
-	// Defines the event listener.
-	const listener = function(event) {
-		let delegateTarget;
-
-		// If opts.composed is true and the event originated from inside a Shadow
-		// tree, check the composed path nodes.
-		if (opts['composed'] && typeof event['composedPath'] === 'function') {
-			const composedPath = event.composedPath();
-			for (let i = 0, node; (node = composedPath[i]); i++) {
-				if (node.nodeType === 1 && matches(node, selector)) {
-					delegateTarget = node;
-				}
-			}
-		} else {
-			// Otherwise check the parents.
-			delegateTarget = closest(event.target, selector, true);
-		}
-
-		if (delegateTarget) {
-			callback.call(delegateTarget, event, delegateTarget);
-		}
-	};
-
-	ancestor.addEventListener(eventType, listener, opts['useCapture']);
-
-	return {
-		destroy: () => {
-			ancestor.removeEventListener(eventType, listener, opts['useCapture']);
-		},
-	};
-}

package/src/vendor/dom-utils/dispatch.ts

@@ -1,59 +0,0 @@
-/**
- * Copyright (c) 2017, Philip Walton <philip@philipwalton.com>
- */
-
-/**
- * Dispatches an event on the passed element.
- * @param {!Element} element The DOM element to dispatch the event on.
- * @param {string} eventType The type of event to dispatch.
- * @param {Object|string=} eventName A string name of the event constructor
- *     to use. Defaults to 'Event' if nothing is passed or 'CustomEvent' if
- *     a value is set on `initDict.detail`. If eventName is given an object
- *     it is assumed to be initDict and thus reassigned.
- * @param {Object=} initDict The initialization attributes for the
- *     event. A `detail` property can be used here to pass custom data.
- * @return {boolean} The return value of `element.dispatchEvent`, which will
- *     be false if any of the event listeners called `preventDefault`.
- */
-export function dispatch(
-	element,
-	eventType,
-	evtName = 'Event',
-	init_dict = {}
-) {
-	let event;
-	let isCustom;
-	let initDict = init_dict;
-	let eventName = evtName;
-
-	// eventName is optional
-	if (typeof eventName === 'object') {
-		initDict = eventName;
-		eventName = 'Event';
-	}
-
-	initDict['bubbles'] = initDict['bubbles'] || false;
-	initDict['cancelable'] = initDict['cancelable'] || false;
-	initDict['composed'] = initDict['composed'] || false;
-
-	// If a detail property is passed, this is a custom event.
-	if ('detail' in initDict) isCustom = true;
-	eventName = isCustom ? 'CustomEvent' : eventName;
-
-	// Tries to create the event using constructors, if that doesn't work,
-	// fallback to `document.createEvent()`.
-	try {
-		event = new window[eventName](eventType, initDict);
-	} catch (err) {
-		event = document.createEvent(eventName);
-		const initMethod = 'init' + (isCustom ? 'Custom' : '') + 'Event';
-		event[initMethod](
-			eventType,
-			initDict['bubbles'],
-			initDict['cancelable'],
-			initDict['detail']
-		);
-	}
-
-	return element.dispatchEvent(event);
-}

package/src/vendor/dom-utils/get-attributes.ts

@@ -1,26 +0,0 @@
-/**
- * Copyright (c) 2017, Philip Walton <philip@philipwalton.com>
- */
-
-/**
- * Gets all attributes of an element as a plain JavaScriot object.
- * @param {Element} element The element whose attributes to get.
- * @return {!Object} An object whose keys are the attribute keys and whose
- *     values are the attribute values. If no attributes exist, an empty
- *     object is returned.
- */
-export function getAttributes(element) {
-	const attrs = {};
-
-	// Validate input.
-	if (!(element && element.nodeType === 1)) return attrs;
-
-	// Return an empty object if there are no attributes.
-	const map = element.attributes;
-	if (map.length === 0) return {};
-
-	for (let i = 0, attr; (attr = map[i]); i++) {
-		attrs[attr.name] = attr.value;
-	}
-	return attrs;
-}

package/src/vendor/dom-utils/index.ts

@@ -1,7 +0,0 @@
-export { closest } from './closest';
-export { delegate } from './delegate';
-export { dispatch } from './dispatch';
-export { getAttributes } from './get-attributes';
-export { matches } from './matches';
-export { parents } from './parents';
-export { parseUrl } from './parse-url';

package/src/vendor/dom-utils/matches.ts

@@ -1,68 +0,0 @@
-/**
- * Copyright (c) 2017, Philip Walton <philip@philipwalton.com>
- */
-
-import { browserOrNode } from '@aws-amplify/core';
-
-const proto =
-	browserOrNode().isBrowser && window['Element']
-		? window['Element'].prototype
-		: null;
-
-const 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 (let i = 0, item; (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);
-	const nodes = element.parentNode.querySelectorAll(selector);
-	for (let i = 0, node; (node = nodes[i]); i++) {
-		if (node === element) return true;
-	}
-	return false;
-}

package/src/vendor/dom-utils/parents.ts

@@ -1,19 +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) {
-	const list = [];
-	let element = ele;
-	while (element && element.parentNode && element.parentNode.nodeType === 1) {
-		element = /** @type {!Element} */ element.parentNode;
-		list.push(element);
-	}
-	return list;
-}