onesignal-cordova-plugin/www/UserNamespace.ts

OneSignal is a high volume Push Notification service for mobile apps. In addition to basic notification delivery, OneSignal also provides tools to localize, target, schedule, and automate notifications that you send.

import PushSubscription from "./PushSubscriptionNamespace";

// Represents the current user state
export interface UserState {
  onesignalId?: string;
  externalId?: string;
}

export interface UserChangedState {
  current: UserState;
}

export default class User {
  // The push subscription associated to the current user.
  pushSubscription: PushSubscription = new PushSubscription();

  private _userStateObserverList: ((event: UserChangedState) => void)[] = [];

  private _processFunctionList(
    array: ((event: UserChangedState) => void)[],
    param: UserChangedState,
  ): void {
    for (let i = 0; i < array.length; i++) {
      array[i](param);
    }
  }

  /**
   * Explicitly set a 2-character language code for the user.
   * @param  {string} language
   * @returns void
   */
  setLanguage(language: string): void {
    window.cordova.exec(
      function () {},
      function () {},
      "OneSignalPush",
      "setLanguage",
      [language],
    );
  }

  /**
   * Aliases
   */

  /**
   * Set an alias for the current user. If this alias label already exists on this user, it will be overwritten with the new alias id.
   * @param  {string} label
   * @param  {string} id
   * @returns void
   */
  addAlias(label: string, id: string): void {
    const jsonKeyValue = { [label]: id };
    window.cordova.exec(
      function () {},
      function () {},
      "OneSignalPush",
      "addAliases",
      [jsonKeyValue],
    );
  }

  /**
   * Set aliases for the current user. If any alias already exists, it will be overwritten to the new values.
   * @param {object} aliases
   * @returns void
   */
  addAliases(aliases: object): void {
    window.cordova.exec(
      function () {},
      function () {},
      "OneSignalPush",
      "addAliases",
      [aliases],
    );
  }

  /**
   * Remove an alias from the current user.
   * @param  {string} label
   * @returns void
   */
  removeAlias(label: string): void {
    window.cordova.exec(
      function () {},
      function () {},
      "OneSignalPush",
      "removeAliases",
      [label],
    );
  }

  /**
   * Remove aliases from the current user.
   * @param  {string[]} labels
   * @returns void
   */
  removeAliases(labels: string[]): void {
    window.cordova.exec(
      function () {},
      function () {},
      "OneSignalPush",
      "removeAliases",
      labels,
    );
  }

  /**
   * Email
   */

  /**
   * Add a new email subscription to the current user.
   * @param  {string} email
   * @returns void
   */
  addEmail(email: string): void {
    window.cordova.exec(
      function () {},
      function () {},
      "OneSignalPush",
      "addEmail",
      [email],
    );
  }

  /**
   * Remove an email subscription from the current user. Returns false if the specified email does not exist on the user within the SDK, and no request will be made.
   * @param {string} email
   * @returns void
   */
  removeEmail(email: string): void {
    window.cordova.exec(
      function () {},
      function () {},
      "OneSignalPush",
      "removeEmail",
      [email],
    );
  }

  /**
   * SMS
   */

  /**
   * Add a new SMS subscription to the current user.
   * @param  {string} smsNumber
   * @returns void
   */
  addSms(smsNumber: string): void {
    window.cordova.exec(
      function () {},
      function () {},
      "OneSignalPush",
      "addSms",
      [smsNumber],
    );
  }

  /**
   * Remove an SMS subscription from the current user. Returns false if the specified SMS number does not exist on the user within the SDK, and no request will be made.
   * @param {string} smsNumber
   * @returns void
   */
  removeSms(smsNumber: string): void {
    window.cordova.exec(
      function () {},
      function () {},
      "OneSignalPush",
      "removeSms",
      [smsNumber],
    );
  }

  /**
   * Tags
   */

  /**
   * Add a tag for the current user. Tags are key:value string pairs used as building blocks for targeting specific users and/or personalizing messages. If the tag key already exists, it will be replaced with the value provided here.
   * @param  {string} key
   * @param  {string} value
   * @returns void
   */
  addTag(key: string, value: string): void {
    const jsonKeyValue = { [key]: value };
    window.cordova.exec(
      function () {},
      function () {},
      "OneSignalPush",
      "addTags",
      [jsonKeyValue],
    );
  }

  /**
   * Add multiple tags for the current user. Tags are key:value string pairs used as building blocks for targeting specific users and/or personalizing messages. If the tag key already exists, it will be replaced with the value provided here.
   * @param  {object} tags
   * @returns void
   */
  addTags(tags: object): void {
    const convertedTags = tags as { [key: string]: unknown };
    Object.keys(tags).forEach(function (key) {
      // forces values to be string types
      if (typeof convertedTags[key] !== "string") {
        convertedTags[key] = JSON.stringify(convertedTags[key]);
      }
    });
    window.cordova.exec(
      function () {},
      function () {},
      "OneSignalPush",
      "addTags",
      [convertedTags],
    );
  }

  /**
   * Remove the data tag with the provided key from the current user.
   * @param  {string} key
   * @returns void
   */
  removeTag(key: string): void {
    window.cordova.exec(
      function () {},
      function () {},
      "OneSignalPush",
      "removeTags",
      [key],
    );
  }

  /**
   * Remove multiple tags with the provided keys from the current user.
   * @param  {string[]} keys
   * @returns void
   */
  removeTags(keys: string[]): void {
    window.cordova.exec(
      function () {},
      function () {},
      "OneSignalPush",
      "removeTags",
      keys,
    );
  }

  /** Returns the local tags for the current user.
   * @returns Promise<{ [key: string]: string }>
   */
  getTags(): Promise<{ [key: string]: string }> {
    return new Promise<{ [key: string]: string }>((resolve, reject) => {
      window.cordova.exec(resolve, reject, "OneSignalPush", "getTags", []);
    });
  }

  /**
   * Add a callback that fires when the OneSignal User state changes.
   * Important: When using the observer to retrieve the onesignalId, check the externalId as well to confirm the values are associated with the expected user.
   * @param  {(event: UserChangedState)=>void} listener
   * @returns void
   */
  addEventListener(
    event: "change",
    listener: (event: UserChangedState) => void,
  ) {
    this._userStateObserverList.push(
      listener as (event: UserChangedState) => void,
    );
    const userCallBackProcessor = (state: UserChangedState) => {
      this._processFunctionList(this._userStateObserverList, state);
    };
    window.cordova.exec(
      userCallBackProcessor,
      function () {},
      "OneSignalPush",
      "addUserStateObserver",
      [],
    );
  }

  /**
   * Remove a User State observer that has been previously added.
   * @param  {(event: UserChangedState)=>void} listener
   * @returns void
   */
  removeEventListener(
    event: "change",
    listener: (event: UserChangedState) => void,
  ) {
    let index = this._userStateObserverList.indexOf(listener);
    if (index !== -1) {
      this._userStateObserverList.splice(index, 1);
    }
  }

  /**
   * Get the nullable OneSignal Id associated with the current user.
   * @returns {Promise<string | null>}
   */
  async getOnesignalId(): Promise<string | null> {
    return new Promise<string | null>((resolve, reject) => {
      window.cordova.exec(
        resolve,
        reject,
        "OneSignalPush",
        "getOnesignalId",
        [],
      );
    });
  }

  /**
   * Get the nullable External Id associated with the current user.
   * @returns {Promise<string | null>}
   */
  async getExternalId(): Promise<string | null> {
    return new Promise<string | null>((resolve, reject) => {
      window.cordova.exec(
        resolve,
        reject,
        "OneSignalPush",
        "getExternalId",
        [],
      );
    });
  }
}