@aws-amplify/notifications 2.0.1-api-v6-models.8035dfc.0 → 2.0.1-api-v6-models.572a7b5.0

package/lib-esm/types.d.ts

@@ -1,39 +0,0 @@
-import { InAppMessagingConfig } from './inAppMessaging/types';
-import { PushNotificationConfig } from './pushNotifications/types';
-export declare type NotificationsCategory = 'Notifications';
-export declare type NotificationsSubCategory = 'InAppMessaging' | 'PushNotification';
-export interface NotificationsProvider {
-    configure(config: object): object;
-    getCategory(): NotificationsCategory;
-    getSubCategory(): NotificationsSubCategory;
-    getProviderName(): string;
-    identifyUser(userId: string, userInfo: UserInfo): Promise<void>;
-}
-export interface NotificationsConfig {
-    Notifications?: {
-        InAppMessaging?: InAppMessagingConfig;
-        PushNotification?: PushNotificationConfig;
-    };
-}
-export declare type UserInfo = {
-    attributes?: Record<string, string[]>;
-    demographic?: {
-        appVersion?: string;
-        locale?: string;
-        make?: string;
-        model?: string;
-        modelVersion?: string;
-        platform?: string;
-        platformVersion?: string;
-        timezone?: string;
-    };
-    location?: {
-        city?: string;
-        country?: string;
-        latitude?: number;
-        longitude?: number;
-        postalCode?: string;
-        region?: string;
-    };
-    metrics?: Record<string, number>;
-};

package/lib-esm/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,sCAAsC"}

package/src/common/AWSPinpointProviderCommon/index.ts

@@ -1,305 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-
-import {
-	Category,
-	ClientDevice,
-	ConsoleLogger,
-	CustomUserAgentDetails,
-	getAmplifyUserAgent,
-	InAppMessagingAction,
-	PushNotificationAction,
-} from '@aws-amplify/core/internals/utils';
-import { Cache, fetchAuthSession } from '@aws-amplify/core';
-
-import {
-	Event as AWSPinpointAnalyticsEvent,
-	putEvents,
-	PutEventsInput,
-	updateEndpoint,
-	UpdateEndpointInput,
-} from '@aws-amplify/core/internals/aws-clients/pinpoint';
-import { v4 as uuid } from 'uuid';
-
-import {
-	NotificationsCategory,
-	NotificationsSubCategory,
-	NotificationsProvider,
-	UserInfo,
-} from '../../types';
-import { PinpointUserInfo } from './types';
-
-export default abstract class AWSPinpointProviderCommon
-	implements NotificationsProvider
-{
-	static category: NotificationsCategory = 'Notifications';
-	static providerName = 'AWSPinpoint';
-
-	protected clientInfo;
-	protected config: Record<string, any> = {};
-	protected endpointInitialized = false;
-	protected initialized = false;
-	protected logger: ConsoleLogger;
-
-	constructor(logger) {
-		// this.config = { storage: new StorageHelper().getStorage() };
-		this.clientInfo = ClientDevice.clientInfo() ?? {};
-		this.logger = logger;
-	}
-
-	/**
-	 * get the category of the plugin
-	 */
-	getCategory() {
-		return AWSPinpointProviderCommon.category;
-	}
-
-	/**
-	 * get the sub-category of the plugin
-	 */
-	abstract getSubCategory(): NotificationsSubCategory;
-
-	/**
-	 * get provider name of the plugin
-	 */
-	getProviderName(): string {
-		return AWSPinpointProviderCommon.providerName;
-	}
-
-	configure(config = {}): Record<string, any> {
-		this.config = { ...this.config, ...config };
-		this.logger.debug(
-			`configure ${this.getProviderName()}${this.getSubCategory()}Provider`,
-			this.config
-		);
-		return this.config;
-	}
-
-	identifyUser = async (userId: string, userInfo: UserInfo): Promise<void> => {
-		if (!this.initialized) {
-			await this.init();
-		}
-		try {
-			await this.updateEndpoint(userId, userInfo);
-		} catch (err) {
-			this.logger.error('Error identifying user', err);
-			throw err;
-		}
-	};
-
-	protected init = async (): Promise<void> => {
-		const { endpointId, storage } = this.config;
-		const providerName = this.getProviderName();
-		try {
-			// Only run sync() if it's available (i.e. React Native)
-			if (typeof storage.sync === 'function') {
-				await storage.sync();
-			}
-			// If an endpoint was not provided via configuration, try to get it from cache
-			if (!endpointId) {
-				this.config.endpointId = await this.getEndpointId();
-			}
-			this.initialized = true;
-		} catch (err) {
-			this.logger.error(`Failed to initialize ${providerName}`, err);
-		}
-	};
-
-	private getUserAgentValue = (): string => {
-		let customUserAgentDetails: CustomUserAgentDetails;
-		if (this.getSubCategory() === 'PushNotification') {
-			customUserAgentDetails = {
-				category: Category.PushNotification,
-				action: PushNotificationAction.None,
-			};
-		} else {
-			customUserAgentDetails = {
-				category: Category.InAppMessaging,
-				action: InAppMessagingAction.IdentifyUser,
-			};
-		}
-
-		return getAmplifyUserAgent(customUserAgentDetails);
-	};
-
-	protected recordAnalyticsEvent = async (
-		event: AWSPinpointAnalyticsEvent
-	): Promise<void> => {
-		// Update credentials
-		this.config.credentials = await this.getCredentials();
-		// Assert required configuration properties to make `putEvents` request are present
-		this.assertNotEmptyConfiguration();
-		const { appId, credentials, endpointId, region } = this.config;
-
-		try {
-			// Create the PutEvents input
-			const input: PutEventsInput = {
-				ApplicationId: appId,
-				EventsRequest: {
-					BatchItem: {
-						[endpointId]: {
-							Endpoint: {},
-							Events: {
-								[uuid()]: event,
-							},
-						},
-					},
-				},
-			};
-			this.logger.debug('recording analytics event');
-			await putEvents(
-				{ credentials, region, userAgentValue: this.getUserAgentValue() },
-				input
-			);
-		} catch (err) {
-			this.logger.error('Error recording analytics event', err);
-			throw err;
-		}
-	};
-
-	protected updateEndpoint = async (
-		userId: string = null,
-		userInfo: PinpointUserInfo = null
-	): Promise<void> => {
-		const credentials = await this.getCredentials();
-		// Shallow compare to determine if credentials stored here are outdated
-		const credentialsUpdated =
-			!this.config.credentials ||
-			Object.keys(credentials).some(
-				key => credentials[key] !== this.config.credentials[key]
-			);
-		// If endpoint is already initialized, and nothing else is changing, just early return
-		if (
-			this.endpointInitialized &&
-			!credentialsUpdated &&
-			!userId &&
-			!userInfo
-		) {
-			return;
-		}
-		// Update credentials
-		this.config.credentials = credentials;
-		// Assert required configuration properties to make `updateEndpoint` request are present
-		this.assertNotEmptyConfiguration();
-		const { appId, endpointId, endpointInfo = {}, region } = this.config;
-		try {
-			const { address, attributes, demographic, location, metrics, optOut } =
-				userInfo ?? {};
-			const { appVersion, make, model, platform, version } = this.clientInfo;
-			// Create the UpdateEndpoint input, prioritizing passed in user info and falling back to
-			// defaults (if any) obtained from the config
-			const input: UpdateEndpointInput = {
-				ApplicationId: appId,
-				EndpointId: endpointId,
-				EndpointRequest: {
-					RequestId: uuid(),
-					EffectiveDate: new Date().toISOString(),
-					ChannelType: endpointInfo.channelType,
-					Address: address ?? endpointInfo.address,
-					Attributes: {
-						...endpointInfo.attributes,
-						...attributes,
-					},
-					Demographic: {
-						AppVersion: appVersion,
-						Make: make,
-						Model: model,
-						ModelVersion: version,
-						Platform: platform,
-						...this.transferKeyToUpperCase({
-							...endpointInfo.demographic,
-							...demographic,
-						}),
-					},
-					Location: this.transferKeyToUpperCase({
-						...endpointInfo.location,
-						...location,
-					}),
-					Metrics: {
-						...endpointInfo.metrics,
-						...metrics,
-					},
-					OptOut: optOut ?? endpointInfo.optOut,
-					User: {
-						UserId: userId ?? endpointInfo.userId ?? credentials.identityId,
-						UserAttributes: attributes ?? endpointInfo.userAttributes,
-					},
-				},
-			};
-			this.logger.debug('updating endpoint');
-			await updateEndpoint(
-				{ credentials, region, userAgentValue: this.getUserAgentValue() },
-				input
-			);
-			this.endpointInitialized = true;
-		} catch (err) {
-			throw err;
-		}
-	};
-
-	private getEndpointId = async (): Promise<string> => {
-		const { appId } = this.config;
-		// Each Pinpoint channel requires its own Endpoint ID
-		// However, Push will share the Analytics endpoint for now so as to not break existing customers
-		const cacheKey =
-			this.getSubCategory() === 'PushNotification'
-				? `${this.getProviderName()}_${appId}`
-				: `${this.getSubCategory()}:${this.getProviderName()}:${appId}`;
-		// First attempt to retrieve the ID from cache
-		const cachedEndpointId = await Cache.getItem(cacheKey);
-		// Found in cache, just return it
-		if (cachedEndpointId) {
-			return cachedEndpointId;
-		}
-		// Otherwise, generate a new ID and store it in long-lived cache before returning it
-		const endpointId = uuid();
-		// Set a longer TTL to avoid endpoint id being deleted after the default TTL (3 days)
-		// Also set its priority to the highest to reduce its chance of being deleted when cache is full
-		const ttl = 1000 * 60 * 60 * 24 * 365 * 100; // 100 years
-		const expiration = new Date().getTime() + ttl;
-		Cache.setItem(cacheKey, endpointId, {
-			expires: expiration,
-			priority: 1,
-		});
-		return endpointId;
-	};
-
-	private getCredentials = async () => {
-		try {
-			const session = await fetchAuthSession();
-			if (!session.credentials) {
-				this.logger.debug('no credentials found');
-				return null;
-			}
-			return { ...session.credentials, identityId: session.identityId };
-		} catch (err) {
-			this.logger.error('Error getting credentials:', err);
-			return null;
-		}
-	};
-
-	private assertNotEmptyConfiguration = () => {
-		const { appId, credentials, region } = this.config;
-		if (!appId || !credentials || !region) {
-			throw new Error(
-				'One or more of credentials, appId or region is not configured'
-			);
-		}
-	};
-
-	/**
-	 * transfer the first letter of the keys to lowercase
-	 * @param {Object} obj - the object need to be transferred
-	 */
-	private transferKeyToUpperCase = (obj: Record<string, any>) => {
-		const ret: Record<string, any> = {};
-
-		for (const key in obj) {
-			if (obj.hasOwnProperty(key)) {
-				const transferredKey = key[0].toUpperCase() + key.slice(1);
-				ret[transferredKey] = this.transferKeyToUpperCase(obj[key]);
-			}
-		}
-		return ret;
-	};
-}

package/src/common/AWSPinpointProviderCommon/types.ts

@@ -1,29 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-
-import { UserInfo } from '../../types';
-
-export interface PinpointProviderConfig {
-	appId: string;
-	region: string;
-}
-
-export interface PinpointUserInfo extends UserInfo {
-	address?: string;
-	optOut?: 'ALL' | 'NONE';
-}
-
-export type ChannelType =
-	| 'ADM'
-	| 'APNS'
-	| 'APNS_SANDBOX'
-	| 'APNS_VOIP'
-	| 'APNS_VOIP_SANDBOX'
-	| 'BAIDU'
-	| 'CUSTOM'
-	| 'EMAIL'
-	| 'GCM'
-	| 'IN_APP'
-	| 'PUSH'
-	| 'SMS'
-	| 'VOICE';

package/src/inAppMessaging/providers/pinpoint/types/errors.ts

@@ -1,12 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-
-export enum UpdateEndpointException {
-	BadRequestException = 'BadRequestException',
-	ForbiddenException = 'ForbiddenException',
-	InternalServerErrorException = 'InternalServerErrorException',
-	MethodNotAllowedException = 'MethodNotAllowedException',
-	NotFoundException = 'NotFoundException',
-	PayloadTooLargeException = 'PayloadTooLargeException',
-	TooManyRequestsException = 'TooManyRequestsException',
-}

package/src/inAppMessaging/sessionTracker/SessionTracker.native.ts

@@ -1,60 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-
-import { ConsoleLogger as Logger } from '@aws-amplify/core/internals/utils';
-import { AppState, AppStateStatus } from 'react-native';
-import noop from 'lodash/noop';
-import {
-	SessionState,
-	SessionStateChangeHandler,
-	SessionTrackerInterface,
-} from './types';
-
-const isActive = appState => appState === 'active';
-const isInactive = appState =>
-	appState === 'inactive' || appState === 'background';
-
-const logger = new Logger('InAppMessagingSessionTracker');
-
-export default class SessionTracker implements SessionTrackerInterface {
-	private currentAppState: AppStateStatus;
-	private sessionStateChangeHandler: SessionStateChangeHandler;
-
-	constructor(sessionStateChangeHandler: SessionStateChangeHandler = noop) {
-		this.currentAppState = 'active';
-		this.sessionStateChangeHandler = sessionStateChangeHandler;
-	}
-
-	start = (): SessionState => {
-		AppState.addEventListener('change', this.appStateChangeHandler);
-		return this.getSessionState();
-	};
-
-	end = (): SessionState => {
-		AppState.removeEventListener('change', this.appStateChangeHandler);
-		return this.getSessionState();
-	};
-
-	private getSessionState = (): SessionState => {
-		if (isActive(this.currentAppState)) {
-			return 'started';
-		}
-		// consider any other app state as session ended
-		return 'ended';
-	};
-
-	private appStateChangeHandler = nextAppState => {
-		// if going from active to inactive
-		if (isActive(this.currentAppState) && isInactive(nextAppState)) {
-			logger.debug('App has gone to the background');
-			this.sessionStateChangeHandler('ended');
-		}
-		// if going from inactive to active
-		if (isInactive(this.currentAppState) && isActive(nextAppState)) {
-			logger.debug('App has come to the foreground');
-			this.sessionStateChangeHandler('started');
-		}
-		// otherwise do nothing but always update current state
-		this.currentAppState = nextAppState;
-	};
-}

package/src/inAppMessaging/sessionTracker/SessionTracker.ts

@@ -1,80 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import {
-	ConsoleLogger as Logger,
-	isBrowser,
-} from '@aws-amplify/core/internals/utils';
-import noop from 'lodash/noop';
-import {
-	SessionState,
-	SessionStateChangeHandler,
-	SessionTrackerInterface,
-} from './types';
-
-// Per https://developer.mozilla.org/en-US/docs/Web/API/Page_Visibility_API
-let hidden: string;
-let visibilityChange: string;
-
-if (isBrowser && document) {
-	if (typeof document.hidden !== 'undefined') {
-		hidden = 'hidden';
-		visibilityChange = 'visibilitychange';
-	} else if (typeof document['msHidden'] !== 'undefined') {
-		hidden = 'msHidden';
-		visibilityChange = 'msvisibilitychange';
-	} else if (typeof document['webkitHidden'] !== 'undefined') {
-		hidden = 'webkitHidden';
-		visibilityChange = 'webkitvisibilitychange';
-	}
-}
-
-const logger = new Logger('InAppMessagingSessionTracker');
-
-export default class SessionTracker implements SessionTrackerInterface {
-	private sessionStateChangeHandler: SessionStateChangeHandler;
-
-	constructor(sessionStateChangeHandler: SessionStateChangeHandler = noop) {
-		this.sessionStateChangeHandler = sessionStateChangeHandler;
-	}
-
-	start = (): SessionState => {
-		if (isBrowser) {
-			document?.addEventListener(
-				visibilityChange,
-				this.visibilityChangeHandler
-			);
-		}
-		return this.getSessionState();
-	};
-
-	end = (): SessionState => {
-		if (isBrowser) {
-			document?.removeEventListener(
-				visibilityChange,
-				this.visibilityChangeHandler
-			);
-		}
-		return this.getSessionState();
-	};
-
-	private getSessionState = (): SessionState => {
-		if (isBrowser && document && !document[hidden]) {
-			return 'started';
-		}
-		// If, for any reason, document is undefined the session will never start
-		return 'ended';
-	};
-
-	private visibilityChangeHandler = () => {
-		if (!isBrowser || !document) {
-			return;
-		}
-		if (document[hidden]) {
-			logger.debug('App is now hidden');
-			this.sessionStateChangeHandler('ended');
-		} else {
-			logger.debug('App is now visible');
-			this.sessionStateChangeHandler('started');
-		}
-	};
-}

package/src/inAppMessaging/sessionTracker/index.ts

@@ -1,6 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-
-import { default as SessionTracker } from './SessionTracker';
-export * from './types';
-export default SessionTracker;

package/src/inAppMessaging/sessionTracker/types.ts

@@ -1,11 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-
-export type SessionState = 'started' | 'ended';
-
-export type SessionStateChangeHandler = (state: SessionState) => void;
-
-export interface SessionTrackerInterface {
-	start: () => SessionState;
-	end: () => SessionState;
-}

package/src/inAppMessaging/types/config.ts

@@ -1,8 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { PinpointProviderConfig } from '../../common/AWSPinpointProviderCommon/types';
-
-export interface InAppMessagingConfig {
-	listenForAnalyticsEvents?: boolean;
-	AWSPinpoint?: PinpointProviderConfig;
-}

package/src/pushNotifications/NotEnabledError.ts

@@ -1,11 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-
-export default class NotEnabledError extends Error {
-	constructor() {
-		super(
-			'Function is unavailable as Push has not been enabled. Please call `Push.enable` before calling this function.'
-		);
-		this.name = 'NotEnabledError';
-	}
-}

package/src/pushNotifications/PlatformNotSupportedError.ts

@@ -1,9 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-
-export default class PlatformNotSupportedError extends Error {
-	constructor() {
-		super('Function not supported on current platform');
-		this.name = 'PlatformNotSupportedError';
-	}
-}

package/src/pushNotifications/providers/AWSPinpointProvider/index.ts

@@ -1,93 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-
-import { addEventListener, AWSPinpointProviderCommon } from '../../../common';
-import { ChannelType } from '../../../common/AWSPinpointProviderCommon/types';
-import {
-	PushNotificationMessage,
-	PushNotificationProvider,
-	NotificationsSubCategory,
-} from '../../types';
-import { AWSPinpointMessageEvent } from './types';
-import { logger } from './utils';
-
-export default class AWSPinpointProvider
-	extends AWSPinpointProviderCommon
-	implements PushNotificationProvider
-{
-	static subCategory: NotificationsSubCategory = 'PushNotification';
-
-	private configured = false;
-
-	constructor() {
-		super(logger);
-	}
-
-	/**
-	 * get the sub-category of the plugin
-	 */
-	getSubCategory() {
-		return AWSPinpointProvider.subCategory;
-	}
-
-	configure = (config = {}): Record<string, any> => {
-		this.config = {
-			...super.configure(config),
-			endpointInfo: { channelType: this.getChannelType() },
-		};
-
-		// some configuration steps should not be re-run even if provider is re-configured for some reason
-		if (!this.configured) {
-			// wire up default Pinpoint message event handling
-			addEventListener('backgroundMessageReceived', message =>
-				this.recordMessageEvent(
-					message,
-					AWSPinpointMessageEvent.BACKGROUND_MESSAGE_RECEIVED
-				)
-			);
-			addEventListener('foregroundMessageReceived', message =>
-				this.recordMessageEvent(
-					message,
-					AWSPinpointMessageEvent.FOREGROUND_MESSAGE_RECEIVED
-				)
-			);
-			const launchNotificationOpenedListener = addEventListener(
-				'launchNotificationsOpened',
-				message => {
-					this.recordMessageEvent(
-						message,
-						AWSPinpointMessageEvent.NOTIFICATION_OPENED
-					);
-					// once we are done with it we can remove the listener
-					launchNotificationOpenedListener?.remove();
-				}
-			);
-			addEventListener('notificationOpened', message => {
-				this.recordMessageEvent(
-					message,
-					AWSPinpointMessageEvent.NOTIFICATION_OPENED
-				);
-				// if we are in this state, we no longer need the listener as the app was launched via some other means
-				launchNotificationOpenedListener?.remove();
-			});
-		}
-
-		this.configured = true;
-		return this.config;
-	};
-
-	registerDevice = async (address: string): Promise<void> => {
-		throw new Error('WIP');
-	};
-
-	private getChannelType = (): ChannelType => {
-		throw new Error('WIP');
-	};
-
-	private recordMessageEvent = async (
-		message: PushNotificationMessage,
-		event: AWSPinpointMessageEvent
-	): Promise<void> => {
-		throw new Error('WIP');
-	};
-}

package/src/pushNotifications/providers/AWSPinpointProvider/types.ts

@@ -1,13 +0,0 @@
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-
-export enum AWSPinpointMessageEventSource {
-	CAMPAIGN = '_campaign',
-	JOURNEY = '_journey',
-}
-
-export enum AWSPinpointMessageEvent {
-	NOTIFICATION_OPENED = 'opened_notification',
-	BACKGROUND_MESSAGE_RECEIVED = 'received_background',
-	FOREGROUND_MESSAGE_RECEIVED = 'received_foreground',
-}