@unifygtm/intent-client/src/client/managers/sessions.ts

JavaScript client for interacting with the Unify Intent API in the browser.

import { v4 as uuidv4 } from 'uuid';

import { ClientSession } from '../../types';
import { LocalStorageService } from '../storage';
import {
  getCurrentPageProperties,
  getCurrentUserAgentData,
  getTimeForMinutesInFuture,
} from '../utils/helpers';

export const CLIENT_SESSION_STORAGE_KEY = 'clientSession';
export const SESSION_MINUTES_TO_EXPIRE = 30;

/**
 * This class is used to store and manage user session data in
 * local browser storage.
 */
export class SessionManager {
  private readonly _writeKey: string;
  private readonly _storageService: LocalStorageService;

  private _currentSession: ClientSession | null;

  constructor(writeKey: string) {
    this._writeKey = writeKey;
    this._storageService = new LocalStorageService(this._writeKey);
    this._currentSession = null;
  }

  /**
   * Gets the current user session if one exists, otherwise creates one.
   *
   * @returns the current or new user session
   */
  public getOrCreateSession = (): ClientSession => {
    return this.getAndUpdateSession() || this.createSession();
  };

  /**
   * Gets the current user session if it exists. If it does exist, also
   * updates the expiration time of the session based on the current time.
   *
   * @returns the current session if it exists, else `undefined`
   */
  private getAndUpdateSession = (): ClientSession | undefined => {
    const session = this._currentSession || this.getStoredSession();
    if (!session) return undefined;

    const isActive = session.expiration > new Date().getTime();
    if (isActive) {
      const updatedSession = this.updateSessionExpiration(session);
      return updatedSession;
    } else {
      return undefined;
    }
  };

  /**
   * Creates a new session in local storage.
   *
   * @param minutesToExpire - optional number of minutes after which the
   *        user session should expire, defaults to `SESSION_MINUTES_TO_EXPIRE`
   * @returns the newly created session
   */
  private createSession = (
    minutesToExpire = SESSION_MINUTES_TO_EXPIRE,
  ): ClientSession => {
    const session: ClientSession = {
      sessionId: uuidv4(),
      startTime: new Date(),
      expiration: getTimeForMinutesInFuture(minutesToExpire),
      initial: getCurrentPageProperties(),
      ...getCurrentUserAgentData(),
    };

    this._currentSession = session;
    this.setStoredSession(session);

    return session;
  };

  /**
   * Updates the expiration time of an existing session in
   * local storage.
   *
   * @param existingSession - the session to update expiration time for
   * @param minutesToExpire - optional number of minutes after which the
   *        session should expire, defaults to `MINUTES_TO_EXPIRE`
   * @returns the updated session object
   */
  private updateSessionExpiration = (
    existingSession: ClientSession,
    minutesToExpire = SESSION_MINUTES_TO_EXPIRE,
  ): ClientSession => {
    const updatedSession: ClientSession = {
      ...existingSession,
      expiration: getTimeForMinutesInFuture(minutesToExpire),
    };
    this._currentSession = updatedSession;
    this.setStoredSession(updatedSession);

    return updatedSession;
  };

  /**
   * Retrieves a session object from local storage.
   *
   * @returns the stored session object, or `null` if none exists
   */
  private getStoredSession = (): ClientSession | null => {
    return this._storageService.get<ClientSession>(CLIENT_SESSION_STORAGE_KEY);
  };

  /**
   * Stores a session object in local storage.
   *
   * @param session - the session to store
   */
  private setStoredSession = (session: ClientSession): void => {
    this._storageService.set(CLIENT_SESSION_STORAGE_KEY, session);
  };
}