@aws-amplify/analytics 7.0.1-preview-testing.034e780.0 → 7.0.1-server-generate-client.1e317a1.0

package/lib-esm/providers/pinpoint/apis/identifyUser.d.ts

@@ -19,8 +19,9 @@ import { IdentifyUserInput } from '../types';
  * await identifyUser({
  *     userId,
  *     userProfile: {
- *         attributes: {
- *             email: [userEmail],
+ *         email: 'userEmail@example.com'
+ *         customProperties: {
+ *             phoneNumber: ['555-555-5555'],
  *         },
  *     }
  * });
@@ -32,8 +33,9 @@ import { IdentifyUserInput } from '../types';
  * await identifyUser({
  *     userId,
  *     userProfile: {
- *         attributes: {
- *             email: [userEmail],
+ *         email: 'userEmail@example.com'
+ *         customProperties: {
+ *             phoneNumber: ['555-555-5555'],
  *         },
  *         demographic: {
  *             platform: 'ios',
@@ -42,4 +44,4 @@ import { IdentifyUserInput } from '../types';
  *     }
  * });
  */
-export declare const identifyUser: ({ userId, userProfile, }: IdentifyUserInput) => Promise<void>;
+export declare const identifyUser: ({ userId, userProfile, options, }: IdentifyUserInput) => Promise<void>;

package/lib-esm/providers/pinpoint/apis/identifyUser.js

@@ -2,8 +2,8 @@
 // SPDX-License-Identifier: Apache-2.0
 import { __awaiter, __generator } from "tslib";
 import { AnalyticsAction } from '@aws-amplify/core/internals/utils';
-import { updateEndpoint } from '@aws-amplify/core/internals/providers/pinpoint';
-import { getAnalyticsUserAgentString } from '../../../utils/userAgent';
+import { updateEndpoint, } from '@aws-amplify/core/internals/providers/pinpoint';
+import { getAnalyticsUserAgentString } from '../../../utils';
 import { resolveConfig, resolveCredentials } from '../utils';
 /**
  * Sends information about a user to Pinpoint. Sending user information allows you to associate a user to their user
@@ -25,8 +25,9 @@ import { resolveConfig, resolveCredentials } from '../utils';
  * await identifyUser({
  *     userId,
  *     userProfile: {
- *         attributes: {
- *             email: [userEmail],
+ *         email: 'userEmail@example.com'
+ *         customProperties: {
+ *             phoneNumber: ['555-555-5555'],
  *         },
  *     }
  * });
@@ -38,8 +39,9 @@ import { resolveConfig, resolveCredentials } from '../utils';
  * await identifyUser({
  *     userId,
  *     userProfile: {
- *         attributes: {
- *             email: [userEmail],
+ *         email: 'userEmail@example.com'
+ *         customProperties: {
+ *             phoneNumber: ['555-555-5555'],
  *         },
  *         demographic: {
  *             platform: 'ios',
@@ -49,24 +51,26 @@ import { resolveConfig, resolveCredentials } from '../utils';
  * });
  */
 export var identifyUser = function (_a) {
-    var userId = _a.userId, userProfile = _a.userProfile;
+    var userId = _a.userId, userProfile = _a.userProfile, options = _a.options;
     return __awaiter(void 0, void 0, void 0, function () {
-        var _b, credentials, identityId, _c, appId, region;
+        var _b, credentials, identityId, _c, appId, region, userAttributes;
         return __generator(this, function (_d) {
             switch (_d.label) {
                 case 0: return [4 /*yield*/, resolveCredentials()];
                 case 1:
                     _b = _d.sent(), credentials = _b.credentials, identityId = _b.identityId;
                     _c = resolveConfig(), appId = _c.appId, region = _c.region;
+                    userAttributes = (options !== null && options !== void 0 ? options : {}).userAttributes;
                     updateEndpoint({
                         appId: appId,
                         category: 'Analytics',
                         credentials: credentials,
                         identityId: identityId,
                         region: region,
+                        userAttributes: userAttributes,
                         userId: userId,
                         userProfile: userProfile,
-                        userAgentValue: getAnalyticsUserAgentString(AnalyticsAction.UpdateEndpoint),
+                        userAgentValue: getAnalyticsUserAgentString(AnalyticsAction.IdentifyUser),
                     });
                     return [2 /*return*/];
             }

package/lib-esm/providers/pinpoint/apis/index.d.ts

@@ -1,2 +1,4 @@
 export { record } from './record';
 export { identifyUser } from './identifyUser';
+export { configureAutoTrack } from './configureAutoTrack';
+export { flushEvents } from './flushEvents';

package/lib-esm/providers/pinpoint/apis/index.js

@@ -2,3 +2,5 @@
 // SPDX-License-Identifier: Apache-2.0
 export { record } from './record';
 export { identifyUser } from './identifyUser';
+export { configureAutoTrack } from './configureAutoTrack';
+export { flushEvents } from './flushEvents';

package/lib-esm/providers/pinpoint/apis/record.d.ts

@@ -10,27 +10,21 @@ import { RecordInput } from '../types';
  * @example
  * ```ts
  * // Send an event to Pinpoint
- * record({
- *     event: {
- * 	       name: eventName,
- *     }
- * })
+ * record({ name: eventName })
  * ```
  *
  * @example
  * ```ts
  * // Send an event to Pinpoint with metrics & custom attributes
  * record({
- *     event: {
- *         name: eventName,
- *         attributes: {
- *             'my-attribute': attributeValue
- *         },
- *         metrics: {
- *             'my-metric': metricValue
- *         }
+ *     name: eventName,
+ *     attributes: {
+ *         'my-attribute': attributeValue
+ *     },
+ *     metrics: {
+ *         'my-metric': metricValue
  *     }
  * })
  * ```
  */
-export declare const record: ({ event }: RecordInput) => void;
+export declare const record: (input: RecordInput) => void;

package/lib-esm/providers/pinpoint/apis/record.js

@@ -1,11 +1,12 @@
 // 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/internals/utils';
+import { Hub, ConsoleLogger } from '@aws-amplify/core';
+import { AMPLIFY_SYMBOL, AnalyticsAction, } from '@aws-amplify/core/internals/utils';
 import { record as recordCore } from '@aws-amplify/core/internals/providers/pinpoint';
 import { AnalyticsValidationErrorCode, assertValidationError, } from '../../../errors';
-import { getAnalyticsUserAgentString } from '../../../utils/userAgent';
+import { getAnalyticsUserAgentString, isAnalyticsEnabled, } from '../../../utils';
 import { resolveConfig, resolveCredentials } from '../utils';
-var logger = new Logger('Analytics');
+var logger = new ConsoleLogger('Analytics');
 /**
  * Records an Analytic event to Pinpoint. Events will be buffered and periodically sent to Pinpoint.
  *
@@ -17,42 +18,39 @@ var logger = new Logger('Analytics');
  * @example
  * ```ts
  * // Send an event to Pinpoint
- * record({
- *     event: {
- * 	       name: eventName,
- *     }
- * })
+ * record({ name: eventName })
  * ```
  *
  * @example
  * ```ts
  * // Send an event to Pinpoint with metrics & custom attributes
  * record({
- *     event: {
- *         name: eventName,
- *         attributes: {
- *             'my-attribute': attributeValue
- *         },
- *         metrics: {
- *             'my-metric': metricValue
- *         }
+ *     name: eventName,
+ *     attributes: {
+ *         'my-attribute': attributeValue
+ *     },
+ *     metrics: {
+ *         'my-metric': metricValue
  *     }
  * })
  * ```
  */
-export var record = function (_a) {
-    var event = _a.event;
-    var _b = resolveConfig(), appId = _b.appId, region = _b.region;
-    assertValidationError(!!event, AnalyticsValidationErrorCode.NoEvent);
-    assertValidationError(!!event.name, AnalyticsValidationErrorCode.NoEventName);
+export var record = function (input) {
+    var _a = resolveConfig(), appId = _a.appId, region = _a.region;
+    if (!isAnalyticsEnabled()) {
+        logger.debug('Analytics is disabled, event will not be recorded.');
+        return;
+    }
+    assertValidationError(!!input.name, AnalyticsValidationErrorCode.NoEventName);
     resolveCredentials()
         .then(function (_a) {
         var credentials = _a.credentials, identityId = _a.identityId;
+        Hub.dispatch('analytics', { event: 'record', data: input, message: 'Recording Analytics event' }, 'Analytics', AMPLIFY_SYMBOL);
         recordCore({
             appId: appId,
             category: 'Analytics',
             credentials: credentials,
-            event: event,
+            event: input,
             identityId: identityId,
             region: region,
             userAgentValue: getAnalyticsUserAgentString(AnalyticsAction.Record),

package/lib-esm/providers/pinpoint/index.d.ts

@@ -1,2 +1,2 @@
-export { record, identifyUser } from './apis';
-export { RecordInput, IdentifyUserInput } from './types/inputs';
+export { record, identifyUser, flushEvents, configureAutoTrack } from './apis';
+export { RecordInput, IdentifyUserInput, ConfigureAutoTrackInput, } from './types/inputs';

package/lib-esm/providers/pinpoint/index.js

@@ -1,3 +1,3 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-export { record, identifyUser } from './apis';
+export { record, identifyUser, flushEvents, configureAutoTrack } from './apis';

package/lib-esm/providers/pinpoint/types/index.d.ts

@@ -1,2 +1,2 @@
-export { UpdateEndpointException } from './errors';
-export { RecordInput, IdentifyUserInput } from './inputs';
+export { RecordInput, IdentifyUserInput, ConfigureAutoTrackInput, } from './inputs';
+export { IdentifyUserOptions } from './options';

package/lib-esm/providers/pinpoint/types/index.js

@@ -1,3 +1,3 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-export { UpdateEndpointException } from './errors';
+export {};

package/lib-esm/providers/pinpoint/types/inputs.d.ts

@@ -1,24 +1,15 @@
-import { UserProfile } from '@aws-amplify/core';
 import { PinpointAnalyticsEvent } from '@aws-amplify/core/internals/providers/pinpoint';
+import { IdentifyUserOptions } from '.';
+import { AnalyticsConfigureAutoTrackInput, AnalyticsIdentifyUserInput } from '../../../types';
 /**
  * Input type for Pinpoint record API.
  */
-export type RecordInput = {
-    /**
-     * An event to send to the default Analytics provider.
-     */
-    event: PinpointAnalyticsEvent;
-};
+export type RecordInput = PinpointAnalyticsEvent;
 /**
  * Input type for Pinpoint identifyUser API.
  */
-export type IdentifyUserInput = {
-    /**
-     * A User ID associated to the current device.
-     */
-    userId: string;
-    /**
-     * Additional information about the user and their device.
-     */
-    userProfile: UserProfile;
-};
+export type IdentifyUserInput = AnalyticsIdentifyUserInput<IdentifyUserOptions>;
+/**
+ * Input type for Pinpoint configureAutoTrack API.
+ */
+export type ConfigureAutoTrackInput = AnalyticsConfigureAutoTrackInput;

package/lib-esm/providers/pinpoint/types/options.d.ts

@@ -0,0 +1,5 @@
+import { PinpointServiceOptions } from '@aws-amplify/core/internals/providers/pinpoint';
+/**
+ * Options specific to Pinpoint identityUser.
+ */
+export type IdentifyUserOptions = Pick<PinpointServiceOptions, 'userAttributes'>;

package/lib-esm/providers/pinpoint/types/options.js

@@ -0,0 +1,3 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+export {};

package/lib-esm/providers/pinpoint/utils/resolveCredentials.d.ts

@@ -2,11 +2,6 @@
  * @internal
  */
 export declare const resolveCredentials: () => Promise<{
-    credentials: {
-        accessKeyId: string;
-        secretAccessKey: string;
-        sessionToken?: string | undefined;
-        expiration?: Date | undefined;
-    };
+    credentials: import("@aws-amplify/core/lib-esm/libraryUtils").AWSCredentials;
     identityId: string | undefined;
 }>;

package/lib-esm/trackers/EventTracker.d.ts

@@ -0,0 +1,10 @@
+import { EventTrackingOptions, TrackerEventRecorder, TrackerInterface } from '../types/trackers';
+export declare class EventTracker implements TrackerInterface {
+    private trackerActive;
+    private options;
+    private eventRecorder;
+    constructor(eventRecorder: TrackerEventRecorder, options?: EventTrackingOptions);
+    configure(eventRecorder: TrackerEventRecorder, options?: EventTrackingOptions): void;
+    cleanup(): void;
+    private handleDocEvent;
+}

package/lib-esm/trackers/EventTracker.js

@@ -0,0 +1,101 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { ConsoleLogger } from '@aws-amplify/core';
+import { isBrowser } from '@aws-amplify/core/internals/utils';
+var DEFAULT_EVENTS = ['click'];
+var DEFAULT_SELECTOR_PREFIX = 'data-amplify-analytics-';
+var DEFAULT_EVENT_NAME = 'event'; // Default event name as sent to the analytics provider
+var logger = new ConsoleLogger('EventTracker');
+var EventTracker = /** @class */ (function () {
+    function EventTracker(eventRecorder, options) {
+        this.options = {};
+        this.trackerActive = false;
+        this.eventRecorder = eventRecorder;
+        this.handleDocEvent = this.handleDocEvent.bind(this);
+        this.configure(eventRecorder, options);
+    }
+    EventTracker.prototype.configure = function (eventRecorder, options) {
+        var _this = this;
+        var _a, _b, _c, _d;
+        this.eventRecorder = eventRecorder;
+        // Clean up any existing listeners
+        this.cleanup();
+        // Apply defaults
+        this.options = {
+            attributes: (_a = options === null || options === void 0 ? void 0 : options.attributes) !== null && _a !== void 0 ? _a : undefined,
+            events: (_b = options === null || options === void 0 ? void 0 : options.events) !== null && _b !== void 0 ? _b : DEFAULT_EVENTS,
+            selectorPrefix: (_c = options === null || options === void 0 ? void 0 : options.selectorPrefix) !== null && _c !== void 0 ? _c : DEFAULT_SELECTOR_PREFIX,
+        };
+        // Register event listeners
+        if (isBrowser()) {
+            (_d = this.options.events) === null || _d === void 0 ? void 0 : _d.forEach(function (targetEvent) {
+                document.addEventListener(targetEvent, _this.handleDocEvent, {
+                    capture: true,
+                });
+            });
+            this.trackerActive = true;
+        }
+    };
+    EventTracker.prototype.cleanup = function () {
+        var _this = this;
+        var _a;
+        // No-op if document listener is not active
+        if (!this.trackerActive) {
+            return;
+        }
+        // Clean up event listeners
+        (_a = this.options.events) === null || _a === void 0 ? void 0 : _a.forEach(function (targetEvent) {
+            document.removeEventListener(targetEvent, _this.handleDocEvent, {
+                capture: true,
+            });
+        });
+    };
+    EventTracker.prototype.handleDocEvent = function (event) {
+        var _a;
+        /**
+         * Example DOM element:
+         *
+         * ```
+         * <button
+         *   data-amplify-analytics-on="click"
+         *   data-amplify-analytics-name="click"
+         *   data-amplify-analytics-attrs="attr1:attr1_value,attr2:attr2_value"
+         * />
+         * ```
+         */
+        var triggerSelector = "[".concat(this.options.selectorPrefix, "on]");
+        var attrSelector = "".concat(this.options.selectorPrefix, "attrs");
+        var eventNameSelector = "".concat(this.options.selectorPrefix, "name");
+        var eventSource = event.target;
+        // Validate that the triggering event type is being tracked
+        if (!((_a = this.options.events) === null || _a === void 0 ? void 0 : _a.includes(event.type))) {
+            return;
+        }
+        if (eventSource instanceof HTMLElement) {
+            var target = eventSource.closest(triggerSelector);
+            if (target) {
+                // Parse event name from the element
+                var eventName = target.getAttribute(eventNameSelector) || DEFAULT_EVENT_NAME;
+                // Parse attributes from the element
+                var elementAttributes_1 = {};
+                var rawElementAttributes = target.getAttribute(attrSelector);
+                rawElementAttributes === null || rawElementAttributes === void 0 ? void 0 : rawElementAttributes.split(/\s*,\s*/).forEach(function (attr) {
+                    var tmp = attr.trim().split(/\s*:\s*/);
+                    elementAttributes_1[tmp[0]] = tmp[1];
+                });
+                // Assemble final list of attributes
+                var attributes = Object.assign({
+                    type: event.type,
+                    target: "".concat(target.localName, " with id ").concat(target.id),
+                }, this.options.attributes, elementAttributes_1);
+                logger.debug('Recording automatically tracked DOM event', {
+                    eventName: eventName,
+                    attributes: attributes,
+                });
+                this.eventRecorder(eventName, attributes);
+            }
+        }
+    };
+    return EventTracker;
+}());
+export { EventTracker };

package/lib-esm/trackers/PageViewTracker.d.ts

@@ -0,0 +1,18 @@
+import { PageViewTrackingOptions, TrackerEventRecorder, TrackerInterface } from '../types/trackers';
+export declare class PageViewTracker implements TrackerInterface {
+    private trackerActive;
+    private options;
+    private eventRecorder;
+    private spaTrackingActive;
+    private pushStateProxy?;
+    private replaceStateProxy?;
+    private originalPushState;
+    private originalReplaceState;
+    constructor(eventRecorder: TrackerEventRecorder, options?: PageViewTrackingOptions);
+    configure(eventRecorder: TrackerEventRecorder, options?: PageViewTrackingOptions): void;
+    cleanup(): void;
+    private setupSPATracking;
+    private setupMPATracking;
+    private handleLocationChange;
+    private urlHasChanged;
+}

package/lib-esm/trackers/PageViewTracker.js

@@ -0,0 +1,113 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { ConsoleLogger } from '@aws-amplify/core';
+import { isBrowser } from '@aws-amplify/core/internals/utils';
+var logger = new ConsoleLogger('PageViewTracker');
+var DEFAULT_EVENT_NAME = 'pageView';
+var DEFAULT_APP_TYPE = 'singlePage';
+var DEFAULT_URL_PROVIDER = function () {
+    return window.location.origin + window.location.pathname;
+};
+var PREV_URL_STORAGE_KEY = 'aws-amplify-analytics-prevUrl';
+var PageViewTracker = /** @class */ (function () {
+    function PageViewTracker(eventRecorder, options) {
+        this.options = {};
+        this.trackerActive = true;
+        this.eventRecorder = eventRecorder;
+        this.spaTrackingActive = false;
+        this.handleLocationChange = this.handleLocationChange.bind(this);
+        this.configure(eventRecorder, options);
+    }
+    PageViewTracker.prototype.configure = function (eventRecorder, options) {
+        var _a, _b, _c, _d, _e, _f;
+        this.eventRecorder = eventRecorder;
+        // Clean up any existing listeners
+        this.cleanup();
+        // Apply defaults
+        this.options = {
+            appType: (_a = options === null || options === void 0 ? void 0 : options.appType) !== null && _a !== void 0 ? _a : DEFAULT_APP_TYPE,
+            attributes: (_b = options === null || options === void 0 ? void 0 : options.attributes) !== null && _b !== void 0 ? _b : undefined,
+            eventName: (_d = (_c = this.options) === null || _c === void 0 ? void 0 : _c.eventName) !== null && _d !== void 0 ? _d : DEFAULT_EVENT_NAME,
+            urlProvider: (_f = (_e = this.options) === null || _e === void 0 ? void 0 : _e.urlProvider) !== null && _f !== void 0 ? _f : DEFAULT_URL_PROVIDER,
+        };
+        // Configure SPA or MPA page view tracking
+        if (isBrowser()) {
+            if (this.options.appType === 'singlePage') {
+                this.setupSPATracking();
+            }
+            else {
+                this.setupMPATracking();
+            }
+            this.trackerActive = true;
+        }
+    };
+    PageViewTracker.prototype.cleanup = function () {
+        var _a, _b;
+        // No-op if document listener is not active
+        if (!this.trackerActive) {
+            return;
+        }
+        // Clean up SPA page view listeners
+        if (this.spaTrackingActive) {
+            window.history.pushState = this.originalPushState;
+            window.history.replaceState = this.originalReplaceState;
+            (_a = this.pushStateProxy) === null || _a === void 0 ? void 0 : _a.revoke();
+            (_b = this.replaceStateProxy) === null || _b === void 0 ? void 0 : _b.revoke();
+            window.removeEventListener('popstate', this.handleLocationChange);
+            this.spaTrackingActive = false;
+        }
+    };
+    PageViewTracker.prototype.setupSPATracking = function () {
+        var _this = this;
+        if (!this.spaTrackingActive) {
+            // Configure proxies on History APIs
+            this.pushStateProxy = Proxy.revocable(window.history.pushState, {
+                apply: function (target, thisArg, args) {
+                    var proxiedResult = target.apply(thisArg, args);
+                    _this.handleLocationChange();
+                    return proxiedResult;
+                },
+            });
+            this.replaceStateProxy = Proxy.revocable(window.history.replaceState, {
+                apply: function (target, thisArg, args) {
+                    var proxiedResult = target.apply(thisArg, args);
+                    _this.handleLocationChange();
+                    return proxiedResult;
+                },
+            });
+            this.originalPushState = window.history.pushState;
+            this.originalReplaceState = window.history.replaceState;
+            window.history.pushState = this.pushStateProxy.proxy;
+            window.history.replaceState = this.replaceStateProxy.proxy;
+            window.addEventListener('popstate', this.handleLocationChange);
+            sessionStorage.removeItem(PREV_URL_STORAGE_KEY);
+            this.spaTrackingActive = true;
+        }
+    };
+    PageViewTracker.prototype.setupMPATracking = function () {
+        this.handleLocationChange();
+    };
+    PageViewTracker.prototype.handleLocationChange = function () {
+        var currentUrl = this.options.urlProvider();
+        var eventName = this.options.eventName || DEFAULT_EVENT_NAME;
+        if (this.urlHasChanged()) {
+            sessionStorage.setItem(PREV_URL_STORAGE_KEY, currentUrl);
+            // Assemble attribute list
+            var attributes = Object.assign({
+                url: currentUrl,
+            }, this.options.attributes);
+            logger.debug('Recording automatically tracked page view event', {
+                eventName: eventName,
+                attributes: attributes,
+            });
+            this.eventRecorder(eventName, attributes);
+        }
+    };
+    PageViewTracker.prototype.urlHasChanged = function () {
+        var prevUrl = sessionStorage.getItem(PREV_URL_STORAGE_KEY);
+        var currUrl = this.options.urlProvider();
+        return currUrl !== prevUrl;
+    };
+    return PageViewTracker;
+}());
+export { PageViewTracker };

package/lib-esm/trackers/SessionTracker.d.ts

@@ -0,0 +1,13 @@
+import { SessionTrackingOptions, TrackerEventRecorder, TrackerInterface } from '../types/trackers';
+export declare class SessionTracker implements TrackerInterface {
+    private options;
+    private eventRecorder;
+    private sessionTrackingActive;
+    private initialEventSent;
+    constructor(eventRecorder: TrackerEventRecorder, options?: SessionTrackingOptions);
+    configure(eventRecorder: TrackerEventRecorder, options?: SessionTrackingOptions): void;
+    cleanup(): void;
+    private handleStateChange;
+    private sessionStarted;
+    private sessionStopped;
+}

package/lib-esm/trackers/SessionTracker.js

@@ -0,0 +1,70 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { sessionListener, } from '@aws-amplify/core/internals/utils';
+import { ConsoleLogger } from '@aws-amplify/core';
+var SESSION_START_EVENT = '_session.start';
+var SESSION_STOP_EVENT = '_session.stop';
+var logger = new ConsoleLogger('SessionTracker');
+var SessionTracker = /** @class */ (function () {
+    function SessionTracker(eventRecorder, options) {
+        this.options = {};
+        this.eventRecorder = eventRecorder;
+        this.sessionTrackingActive = false;
+        this.initialEventSent = false;
+        this.handleStateChange = this.handleStateChange.bind(this);
+        this.configure(eventRecorder, options);
+    }
+    SessionTracker.prototype.configure = function (eventRecorder, options) {
+        var _a;
+        this.eventRecorder = eventRecorder;
+        // Clean up any existing listeners
+        this.cleanup();
+        // Apply defaults
+        this.options = {
+            attributes: (_a = options === null || options === void 0 ? void 0 : options.attributes) !== null && _a !== void 0 ? _a : {},
+        };
+        // Setup state listeners
+        if (!this.sessionTrackingActive) {
+            sessionListener.addStateChangeListener(this.handleStateChange, !this.initialEventSent);
+            this.sessionTrackingActive = true;
+        }
+    };
+    SessionTracker.prototype.cleanup = function () {
+        if (this.sessionTrackingActive) {
+            sessionListener.removeStateChangeListener(this.handleStateChange);
+        }
+        this.sessionTrackingActive = false;
+    };
+    SessionTracker.prototype.handleStateChange = function (state) {
+        if (state === 'started') {
+            this.sessionStarted();
+        }
+        else {
+            this.sessionStopped();
+        }
+    };
+    SessionTracker.prototype.sessionStarted = function () {
+        var _a;
+        var attributes = (_a = this.options.attributes) !== null && _a !== void 0 ? _a : {};
+        logger.debug('Recording automatically tracked page view event', {
+            SESSION_START_EVENT: SESSION_START_EVENT,
+            attributes: attributes,
+        });
+        this.eventRecorder(SESSION_START_EVENT, attributes);
+        // NOTE: The initial event will not be re-sent on re-configuration (e.g. to add additional custom attributes)
+        if (!this.initialEventSent) {
+            this.initialEventSent = true;
+        }
+    };
+    SessionTracker.prototype.sessionStopped = function () {
+        var _a;
+        var attributes = (_a = this.options.attributes) !== null && _a !== void 0 ? _a : {};
+        logger.debug('Recording automatically tracked page view event', {
+            SESSION_STOP_EVENT: SESSION_STOP_EVENT,
+            attributes: attributes,
+        });
+        this.eventRecorder(SESSION_STOP_EVENT, attributes);
+    };
+    return SessionTracker;
+}());
+export { SessionTracker };

package/lib-esm/trackers/SessionTracker.native.d.ts

@@ -0,0 +1,13 @@
+import { SessionTrackingOptions, TrackerEventRecorder, TrackerInterface } from '../types/trackers';
+export declare class SessionTracker implements TrackerInterface {
+    private options;
+    private eventRecorder;
+    private initialEventSent;
+    private sessionTrackingActive;
+    constructor(eventRecorder: TrackerEventRecorder, options?: SessionTrackingOptions);
+    configure(eventRecorder: TrackerEventRecorder, options?: SessionTrackingOptions): void;
+    cleanup(): void;
+    private handleStateChange;
+    private sessionStarted;
+    private sessionStopped;
+}