import type { AvatarUrls } from './avatarUrls';

/**
 * User details permitted by the user's Atlassian Account privacy settings. However, be aware of these exceptions:*
 *
 * - User record deleted from Atlassian: This occurs as the result of a right to be forgotten request. In this case,
 *   `displayName` provides an indication and other parameters have default values or are blank (for example, email is
 *   blank).
 * - User record corrupted: This occurs as a results of events such as a server import and can only happen to deleted
 *   users. In this case, `accountId` returns _unknown_ and all other parameters have fallback values.
 * - User record unavailable: This usually occurs due to an internal service outage. In this case, all parameters have
 *   fallback values.
 */
export interface User {
  /**
   * The account ID of the user, which uniquely identifies the user across all Atlassian products. For example,
   * _5b10ac8d82e05b22cc7d4ef5_.
   */
  accountId: string;
  /**
   * The type of account represented by this user. This will be one of 'atlassian' (normal users), 'app' (application
   * user) or 'customer' (Jira Service Desk customer user)
   */
  accountType: string;
  /** Whether the user is active. */
  active: boolean;
  avatarUrls: AvatarUrls;
  /** The display name of the user. Depending on the user’s privacy settings, this may return an alternative value. */
  displayName: string;
  /** The email address of the user. Depending on the user’s privacy settings, this may be returned as null. */
  emailAddress: string;
  /** The URL of the user. */
  self: string;
  /**
   * The time zone specified in the user's profile. Depending on the user’s privacy settings, this may be returned as
   * null.
   */
  timeZone: string | null;
}