// Generated by delombok at Tue Dec 10 13:42:03 UTC 2024
/*
 * Copyright (c) 2010-2024 Mark Allen, Norbert Bartels.
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */
package com.restfb.types;

import static com.restfb.util.DateUtils.toDateFromShortFormat;
import static com.restfb.util.StringUtils.isBlank;
import static java.util.Collections.unmodifiableList;
import java.math.BigDecimal;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;
import com.restfb.Facebook;
import com.restfb.JsonMapper;
import com.restfb.JsonMapper.JsonMappingCompleted;
import com.restfb.annotation.GraphAPI;
import com.restfb.types.features.HasCover;
import com.restfb.types.features.HasProfilePicture;

/**
 * Represents the <a href="https://developers.facebook.com/docs/graph-api/reference/user">User Graph API type</a>.
 * 
 * @author <a href="http://restfb.com">Mark Allen</a>
 * @author Patrick Alberts
 * @since 1.5
 */
public class User extends NamedFacebookType implements HasProfilePicture, HasCover {
  /**
   * Social context for this person
   */
  @Facebook
  private FacebookType context;
  /**
   * The user's first name.
   * 
   */
  @Facebook("first_name")
  private String firstName;
  /**
   * The user's middle name.
   * 
   */
  @Facebook("middle_name")
  private String middleName;
  /**
   * The person's name formatted to correctly handle Chinese, Japanese, or Korean ordering.
   */
  @Facebook("name_format")
  private String nameFormat;
  /**
   * The person's payment pricepoints
   */
  @Facebook("payment_pricepoints")
  private PaymentPricepoints paymentPricepoints;
  /**
   * The profile picture URL of the Messenger user. The URL will expire.
   */
  @Facebook("profile_pic")
  private String profilePic;
  /**
   * The user's last name.
   * 
   */
  @Facebook("last_name")
  private String lastName;
  /**
   * Shortened, locale-aware name for the person.
   */
  @Facebook("short_name")
  @GraphAPI(since = "2.9")
  private String shortName;
  /**
   * The person's cover photo
   */
  @Facebook
  private CoverPhoto cover;
  /**
   * A link to the person's Timeline.
   *
   * The link will only resolve if the person clicking the link is logged
   * into Facebook and is a friend of the person whose profile is being viewed.
   * 
   */
  @Facebook
  private String link;
  /**
   * The user's biographical snippet.
   */
  @Facebook
  @GraphAPI(until = "2.7")
  private String bio;
  /**
   * The user's favorite quotes.
   * 
   */
  @Facebook
  private String quotes;
  /**
   * Unspecific age range that this person's age fits into.
   * 
   */
  @Facebook("age_range")
  private AgeRange ageRange;
  /**
   * The user's birthday as a {@code String}.
   * <p>
   * Will always succeed, even if the user has specified month/year format only.
   * If you'd like to use a typed version of this accessor,
   * call {@link #getBirthdayAsDate()} instead.
   *
   * "The person's birthday. This is a fixed format string, like `MM/DD/YYYY`.
   * However, people can control who can see the year they were
   * born separately from the month and day so this string can be
   * only the year (YYYY) or the month + day (MM/DD)",
   * 
   */
  @Facebook
  private String birthday;
  /**
   * The proxied or contact email address granted by the user.
   * 
   */
  @Facebook
  private String email;
  /**
   * The user's timezone offset.
   * 
   */
  @Facebook
  private Double timezone;
  /**
   * Indicates whether the account has been verified. This is distinct from the <code>is_verified</code> field. Someone
   * is considered verified if they take any of the following actions:
   * <ul>
   * <li>Register for mobile</li>
   * <li>Confirm their account via SMS</li>
   * <li>Enter a valid credit card</li>
   * </ul>
   * 
   */
  @Facebook
  private Boolean verified;
  /**
   * Video upload limits
   */
  @Facebook("video_upload_limits")
  private VideoUploadLimits videoUploadLimits;
  /**
   * The user's gender.
   * 
   */
  @Facebook
  private String gender;
  /**
   * The user's locale.
   * 
   */
  @Facebook
  private String locale;
  /**
   * The person's PGP public key
   */
  @Facebook("public_key")
  private String publicKey;
  /**
   * The user's Likes
   */
  @Facebook
  private Likes likes;
  @Facebook("picture")
  private transient String rawPicture;
  /**
   * The user's picture, if provided.
   * 
   * To force Facebook to fill the <code>picture</code> field you have to fetch the user with the
   * <code>fields=picture</code> parameter, otherwise the picture is <code>null</code>.
   * 
   * @since 1.6.16
   */
  private ProfilePictureSource picture;
  /**
   * Duplicate mapping for "hometown" since FB can return it differently in different situations.
   * 
   * -- GETTER -- The user's hometown.
   * <p>
   * Sometimes this can be {@code null} - check {@link #getHometownName()} instead in that case.
   * 
   */
  @Facebook
  private NamedFacebookType hometown;
  /**
   * Duplicate mapping for "hometown" since FB can return it differently in different situations.
   */
  @Facebook("hometown")
  private String hometownAsString;
  /**
   * A profile based app scoped ID. It is used to query avatars
   */
  @Facebook("id_for_avatars")
  private String idForAvatars;
  /**
   * he person's current location as entered by them on their profile.
   *
   * This field requires the `user_location` permission.
   */
  @Facebook
  private NamedFacebookType location;
  /**
   * The time that the shared loginneeds to be upgraded to Business Manager by
   */
  @Facebook("shared_login_upgrade_required_by")
  private Date sharedLoginUpgradeRequiredBy;
  /**
   * The user's significant other.
   * 
   */
  @Facebook("significant_other")
  private User significantOther;
  /**
   * Whether the user can add a Donate Button to their Live Videos
   */
  @Facebook("supports_donate_button_in_live_video")
  private Boolean supportsDonateButtonInLiveVideo;
  /**
   * Date the user's profile was updated.
   * 
   */
  @Facebook("updated_time")
  private Date updatedTime;
  /**
   * An anonymous, but unique identifier for the user.
   * 
   */
  @Facebook("third_party_id")
  private String thirdPartyId;
  /**
   * The user's currency preferences.
   * <p>
   * Further documentation available on Facebook's
   * <a href="https://developers.facebook.com/docs/payments/user_currency">Displaying prices in user's currency</a>
   * page.
   * 
   * @since 1.6.12
   */
  @Facebook
  private Currency currency;
  /**
   * This returns a string which is the same for this person across all the apps managed by the same Business Manager.
   * 
   * @since 1.7.0
   */
  @Facebook("token_for_business")
  private String tokenForBusiness;
  /**
   * Install type.
   */
  @Facebook("install_type")
  private String installType;
  /**
   * Is the app making the request installed?
   */
  @Facebook
  private Boolean installed;
  /**
   * People with large numbers of followers can have the authenticity of their identity manually verified by Facebook.
   * This field indicates whether the person's profile is verified in this way.
   *
   * This is distinct from the <code>verified</code> field
   */
  @Facebook("is_verified")
  private Boolean isVerified;
  @Facebook("is_work_account")
  private Boolean isWorkAccount;
  /**
   * if the current user is a guest user. should always return false.
   */
  @Facebook("is_guest_user")
  private Boolean isGuestUser;
  @Facebook("meeting_for")
  private List<String> meetingFor = new ArrayList<>();
  @Facebook
  private List<UserDevice> devices = new ArrayList<>();
  @Facebook
  private List<Sport> sports = new ArrayList<>();
  @Facebook("favorite_teams")
  private List<Experience> favoriteTeams = new ArrayList<>();
  @Facebook("favorite_athletes")
  private List<Experience> favoriteAthletes = new ArrayList<>();
  @Facebook("inspirational_people")
  private List<Experience> inspirationalPeople = new ArrayList<>();
  @Facebook
  private List<Experience> languages = new ArrayList<>();
  @Facebook
  private List<PageLabel> labels = new ArrayList<>();
  @Facebook("ids_for_apps")
  private List<UserIDForApp> idsForApps = new ArrayList<>();
  @Facebook("ids_for_business")
  private List<UserIDForApp> idsForBusiness = new ArrayList<>();
  @Facebook("ids_for_pages")
  private List<UserIDForPage> idsForPages = new ArrayList<>();
  @Facebook("invitable_friends")
  private List<UserInvitableFriend> invitableFriends = new ArrayList<>();
  private static final long serialVersionUID = 1L;


  /**
   * Represents the <a href="http://developers.facebook.com/docs/reference/api/user">Sport Graph API type</a>.
   * 
   * @author Patrick Alberts
   * @since 1.6.3
   */
  public static class Sport extends NamedFacebookType {
    @Facebook
    private List<NamedFacebookType> with = new ArrayList<>();
    private static final long serialVersionUID = 1L;

    /**
     * Friends associated with this sport.
     * 
     * @return Friends associated with this sport.
     */
    public List<NamedFacebookType> getWith() {
      return unmodifiableList(with);
    }

    public boolean addWith(NamedFacebookType withSport) {
      return with.add(withSport);
    }

    public boolean removeWith(NamedFacebookType withSport) {
      return with.remove(withSport);
    }
  }


  /**
   * Represents the <a href="https://developers.facebook.com/docs/payments/user_currency">Currency Graph API type</a>.
   * 
   * @author <a href="http://restfb.com">Mark Allen</a>
   * @since 1.6.12
   */
  public static class Currency extends AbstractFacebookType {
    /**
     * The ISO-4217-3 code for the user's preferred currency (defaulting to USD if the user hasn't set one).
     * 
     */
    @Facebook("user_currency")
    private String userCurrency;
    /**
     * The number of Facebook Credits that equate in value to one unit of {@code user_currency}.
     * 
     */
    @Facebook("currency_exchange")
    private BigDecimal currencyExchange;
    /**
     * The number of units of {@code user_currency} that equate in value to one Credit.
     * <p>
     * To calculate the local currency amount based on the credits price, compute
     * {@code credits_price * currency_exchange_inverse}.
     * 
     */
    @Facebook("currency_exchange_inverse")
    private BigDecimal currencyExchangeInverse;
    /**
     * The number by which a price should be divided for display in {@code user_currency} units.
     * <p>
     * For example, a price of $1.20 will be represented by the Facebook API as "120", which you should divide by the
     * USD {@code currency_offset} of 100 to arrive back at 1.20.
     * 
     */
    @Facebook("currency_offset")
    private BigDecimal currencyOffset;
    private static final long serialVersionUID = 1L;

    /**
     * The ISO-4217-3 code for the user's preferred currency (defaulting to USD if the user hasn't set one).
     * 
     * @return The ISO-4217-3 code for the user's preferred currency (defaulting to USD if the user hasn't set one).
     */
    @java.lang.SuppressWarnings("all")
    public String getUserCurrency() {
      return this.userCurrency;
    }

    /**
     * The ISO-4217-3 code for the user's preferred currency (defaulting to USD if the user hasn't set one).
     * 
     */
    @java.lang.SuppressWarnings("all")
    public void setUserCurrency(final String userCurrency) {
      this.userCurrency = userCurrency;
    }

    /**
     * The number of Facebook Credits that equate in value to one unit of {@code user_currency}.
     * 
     * @return The number of Facebook Credits that equate in value to one unit of {@code user_currency}.
     */
    @java.lang.SuppressWarnings("all")
    public BigDecimal getCurrencyExchange() {
      return this.currencyExchange;
    }

    /**
     * The number of Facebook Credits that equate in value to one unit of {@code user_currency}.
     * 
     */
    @java.lang.SuppressWarnings("all")
    public void setCurrencyExchange(final BigDecimal currencyExchange) {
      this.currencyExchange = currencyExchange;
    }

    /**
     * The number of units of {@code user_currency} that equate in value to one Credit.
     * <p>
     * To calculate the local currency amount based on the credits price, compute
     * {@code credits_price * currency_exchange_inverse}.
     * 
     * @return The number of units of {@code user_currency} that equate in value to one Credit.
     */
    @java.lang.SuppressWarnings("all")
    public BigDecimal getCurrencyExchangeInverse() {
      return this.currencyExchangeInverse;
    }

    /**
     * The number of units of {@code user_currency} that equate in value to one Credit.
     * <p>
     * To calculate the local currency amount based on the credits price, compute
     * {@code credits_price * currency_exchange_inverse}.
     * 
     */
    @java.lang.SuppressWarnings("all")
    public void setCurrencyExchangeInverse(final BigDecimal currencyExchangeInverse) {
      this.currencyExchangeInverse = currencyExchangeInverse;
    }

    /**
     * The number by which a price should be divided for display in {@code user_currency} units.
     * <p>
     * For example, a price of $1.20 will be represented by the Facebook API as "120", which you should divide by the
     * USD {@code currency_offset} of 100 to arrive back at 1.20.
     * 
     * @return The number by which a price should be divided for display in {@code user_currency} units.
     */
    @java.lang.SuppressWarnings("all")
    public BigDecimal getCurrencyOffset() {
      return this.currencyOffset;
    }

    /**
     * The number by which a price should be divided for display in {@code user_currency} units.
     * <p>
     * For example, a price of $1.20 will be represented by the Facebook API as "120", which you should divide by the
     * USD {@code currency_offset} of 100 to arrive back at 1.20.
     * 
     */
    @java.lang.SuppressWarnings("all")
    public void setCurrencyOffset(final BigDecimal currencyOffset) {
      this.currencyOffset = currencyOffset;
    }
  }


  /**
   * Represents the <a href="https://developers.facebook.com/docs/graph-api/reference/user-device/">User Device
   * Graph API type</a>.
   * 
   * @author <a href="http://restfb.com">Norbert Bartels</a>
   */
  public static class UserDevice extends AbstractFacebookType {
    private static final long serialVersionUID = 1L;
    @Facebook
    private String hardware;
    @Facebook
    private String os;

    @java.lang.SuppressWarnings("all")
    public String getHardware() {
      return this.hardware;
    }

    @java.lang.SuppressWarnings("all")
    public void setHardware(final String hardware) {
      this.hardware = hardware;
    }

    @java.lang.SuppressWarnings("all")
    public String getOs() {
      return this.os;
    }

    @java.lang.SuppressWarnings("all")
    public void setOs(final String os) {
      this.os = os;
    }
  }


  public static class AgeRange extends AbstractFacebookType {
    private static final long serialVersionUID = 1L;
    /**
     * The lower bounds of the range for this person's age.
     * 
     */
    @Facebook
    private Integer min;
    /**
     * The upper bounds of the range for this person's age.
     * 
     */
    @Facebook
    private Integer max;

    /**
     * The lower bounds of the range for this person's age.
     * 
     * @return The lower bounds of the range for this person's age.
     */
    @java.lang.SuppressWarnings("all")
    public Integer getMin() {
      return this.min;
    }

    /**
     * The lower bounds of the range for this person's age.
     * 
     */
    @java.lang.SuppressWarnings("all")
    public void setMin(final Integer min) {
      this.min = min;
    }

    /**
     * The upper bounds of the range for this person's age.
     * 
     * @return The upper bounds of the range for this person's age.
     */
    @java.lang.SuppressWarnings("all")
    public Integer getMax() {
      return this.max;
    }

    /**
     * The upper bounds of the range for this person's age.
     * 
     */
    @java.lang.SuppressWarnings("all")
    public void setMax(final Integer max) {
      this.max = max;
    }
  }

  /**
   * The user's birthday, typed to {@code java.util.Date} if possible.
   * 
   * @return The user's birthday, or {@code null} if unavailable or only available in month/year format.
   */
  public Date getBirthdayAsDate() {
    if (isBlank(getBirthday()) || getBirthday().split("/").length < 2) {
      return null;
    }
    return toDateFromShortFormat(birthday);
  }

  @JsonMappingCompleted
  protected void jsonMappingCompleted(JsonMapper jsonMapper) {
    picture = convertPicture(jsonMapper, rawPicture);
  }

  /**
   * The user's hometown name.
   * 
   * @return The user's hometown name.
   */
  public String getHometownName() {
    if (getHometown() != null) return getHometown().getName();
    return hometownAsString;
  }

  /**
   * Businesses can claim ownership of multiple apps using Business Manager.
   *
   * This method returns the list of IDs that this user has in any of those other apps
   * 
   * @return list of ids a user has in other apps
   */
  public List<UserIDForApp> getIdsForApps() {
    return unmodifiableList(idsForApps);
  }

  public boolean addIdsForApps(UserIDForApp userId) {
    return idsForApps.add(userId);
  }

  public boolean removeIdsForApps(UserIDForApp userId) {
    return idsForApps.remove(userId);
  }

  /**
   * Businesses can claim ownership of multiple apps using Business Manager.
   *
   * This edge returns the list of IDs that this user has in any of those other apps
   *
   * @return list of ids a user has in other apps
   */
  public List<UserIDForApp> getIdsForBusiness() {
    return unmodifiableList(idsForBusiness);
  }

  public boolean addIdsForBusiness(UserIDForApp userId) {
    return idsForBusiness.add(userId);
  }

  public boolean removeIdsForBusiness(UserIDForApp userId) {
    return idsForBusiness.remove(userId);
  }

  /**
   * Businesses can claim ownership of apps and pages using Business Manager.
   *
   * This edge returns the list of IDs that this user has in any of the pages owned by this business.
   *
   * @return list of ids a user has in other pages
   */
  public List<UserIDForPage> getIdsForPages() {
    return unmodifiableList(idsForPages);
  }

  public boolean addIdsForPages(UserIDForPage userId) {
    return idsForPages.add(userId);
  }

  public boolean removeIdsForPages(UserIDForPage userId) {
    return idsForPages.remove(userId);
  }

  /**
   * What genders the user is interested in meeting.
   * 
   * @return What genders the user is interested in meeting.
   */
  public List<String> getMeetingFor() {
    return unmodifiableList(meetingFor);
  }

  public boolean addMeetingFor(String gender) {
    return meetingFor.add(gender);
  }

  public boolean removeMeetingFor(String gender) {
    return meetingFor.remove(gender);
  }

  /**
   * The list of devices the person is using.
   * 
   * This will return only iOS and Android devices
   * 
   * @return The list of devices the person is using.
   */
  public List<UserDevice> getDevices() {
    return unmodifiableList(devices);
  }

  public boolean addDevice(UserDevice device) {
    return devices.add(device);
  }

  public boolean removeDevice(UserDevice device) {
    return devices.remove(device);
  }

  /**
   * A list of the sports from the user's profile.
   * 
   * @return A list of the sports from this user's profile.
   */
  public List<Sport> getSports() {
    return unmodifiableList(sports);
  }

  public boolean addSport(Sport sportItem) {
    return sports.add(sportItem);
  }

  public boolean removeSport(Sport sportItem) {
    return sports.remove(sportItem);
  }

  /**
   * A list of the favorite sports teams from the user's profile.
   * 
   * @return A list of the favorite sports teams from the user's profile.
   */
  public List<Experience> getFavoriteTeams() {
    return unmodifiableList(favoriteTeams);
  }

  public boolean addFavoriteTeam(Experience team) {
    return favoriteTeams.add(team);
  }

  public boolean removeFavoriteTeam(Experience team) {
    return favoriteTeams.remove(team);
  }

  /**
   * A list of the favorite athletes from the user's profile.
   * 
   * @return A list of the favorite athletes from the user's profile.
   */
  public List<Experience> getFavoriteAthletes() {
    return unmodifiableList(favoriteAthletes);
  }

  public boolean addFavoriteAthlete(Experience athlet) {
    return favoriteAthletes.add(athlet);
  }

  public boolean removeFavoriteAthlete(Experience athlet) {
    return favoriteAthletes.remove(athlet);
  }

  /**
   * The person's inspirational people.
   *
   * @return The person's inspirational people.
   */
  public List<Experience> getInspirationalPeople() {
    return unmodifiableList(inspirationalPeople);
  }

  public boolean addInspirationalPeople(Experience person) {
    return inspirationalPeople.add(person);
  }

  public boolean removeInspirationalPeople(Experience person) {
    return inspirationalPeople.remove(person);
  }

  /**
   * A list of the languages from the user's profile.
   * 
   * @return A list of the languages from the user's profile.
   */
  public List<Experience> getLanguages() {
    return unmodifiableList(languages);
  }

  public boolean addLanguage(Experience language) {
    return languages.add(language);
  }

  public boolean removeLanguage(Experience language) {
    return languages.remove(language);
  }

  /**
   * Page labels of this user
   *
   * @return labels of this user
   */
  @GraphAPI(since = "2.6")
  public List<PageLabel> getLabels() {
    return unmodifiableList(labels);
  }

  public boolean addLabel(PageLabel label) {
    return labels.add(label);
  }

  public boolean removeLabels(PageLabel label) {
    return labels.remove(label);
  }

  /**
   * A list of friends that can be invited to install a Facebook Canvas app
   * 
   * @return A list of friends that can be invited to install a Facebook Canvas app
   */
  public List<UserInvitableFriend> getInvitableFriends() {
    return unmodifiableList(invitableFriends);
  }

  public boolean addInvitableFriend(UserInvitableFriend friend) {
    return invitableFriends.add(friend);
  }

  public boolean removeInvitableFriend(UserInvitableFriend friend) {
    return invitableFriends.remove(friend);
  }


  /**
   * Represents the <a href="https://developers.facebook.com/docs/graph-api/reference/secure-browsing/">Secure Browsing
   * Graph API type</a>.
   */
  public static class SecureBrowsing extends AbstractFacebookType {
    /**
     * Enabled
     */
    @Facebook
    private Boolean enabled;

    /**
     * Enabled
     *
     * @return Enabled
     */
    @java.lang.SuppressWarnings("all")
    public Boolean getEnabled() {
      return this.enabled;
    }

    /**
     * Enabled
     */
    @java.lang.SuppressWarnings("all")
    public void setEnabled(final Boolean enabled) {
      this.enabled = enabled;
    }
  }


  /**
   * Represents the <a href="https://developers.facebook.com/docs/graph-api/reference/payment-pricepoints/">Payment
   * Pricepoints Graph API type</a>.
   */
  public static class PaymentPricepoints extends AbstractFacebookType {
    @Facebook
    private List<PaymentPricepoint> mobile = new ArrayList<>();

    /**
     * Mobile payment pricepoints
     * 
     * @return Mobile payment pricepoints
     */
    public List<PaymentPricepoint> getMobile() {
      return unmodifiableList(mobile);
    }

    public boolean addMobile(PaymentPricepoint language) {
      return mobile.add(language);
    }

    public boolean removeMobile(PaymentPricepoint language) {
      return mobile.remove(language);
    }
  }


  /**
   * Represents the <a href="https://developers.facebook.com/docs/graph-api/reference/payment-pricepoint/">Payment
   * Pricepoint Graph API type</a>.
   */
  public static class PaymentPricepoint extends AbstractFacebookType {
    @Facebook
    private Double credits;
    @Facebook("local_currency")
    private String localCurrency;
    @Facebook("user_price")
    private String userPrice;

    @java.lang.SuppressWarnings("all")
    public Double getCredits() {
      return this.credits;
    }

    @java.lang.SuppressWarnings("all")
    public void setCredits(final Double credits) {
      this.credits = credits;
    }

    @java.lang.SuppressWarnings("all")
    public String getLocalCurrency() {
      return this.localCurrency;
    }

    @java.lang.SuppressWarnings("all")
    public void setLocalCurrency(final String localCurrency) {
      this.localCurrency = localCurrency;
    }

    @java.lang.SuppressWarnings("all")
    public String getUserPrice() {
      return this.userPrice;
    }

    @java.lang.SuppressWarnings("all")
    public void setUserPrice(final String userPrice) {
      this.userPrice = userPrice;
    }
  }


  /**
   * Represents the <a href="https://developers.facebook.com/docs/graph-api/reference/video-upload-limits/">Video Upload
   * Limits Graph API type</a>.
   */
  public static class VideoUploadLimits extends AbstractFacebookType {
    @Facebook
    private Long length;
    @Facebook
    private Long size;

    @java.lang.SuppressWarnings("all")
    public Long getLength() {
      return this.length;
    }

    @java.lang.SuppressWarnings("all")
    public void setLength(final Long length) {
      this.length = length;
    }

    @java.lang.SuppressWarnings("all")
    public Long getSize() {
      return this.size;
    }

    @java.lang.SuppressWarnings("all")
    public void setSize(final Long size) {
      this.size = size;
    }
  }


  public static class Experience extends NamedFacebookType {
    @Facebook
    private String description;
    @Facebook
    private User from;
    @Facebook
    private List<User> with = new ArrayList<>();

    /**
     * Tagged users
     * 
     * @return Tagged users
     */
    public List<User> getWith() {
      return unmodifiableList(with);
    }

    public boolean addWith(User with) {
      return this.with.add(with);
    }

    public boolean removeWith(User with) {
      return this.with.remove(with);
    }

    @java.lang.SuppressWarnings("all")
    public String getDescription() {
      return this.description;
    }

    @java.lang.SuppressWarnings("all")
    public void setDescription(final String description) {
      this.description = description;
    }

    @java.lang.SuppressWarnings("all")
    public User getFrom() {
      return this.from;
    }

    @java.lang.SuppressWarnings("all")
    public void setFrom(final User from) {
      this.from = from;
    }
  }

  /**
   * Social context for this person
   *
   * @return Social context for this person
   */
  @java.lang.SuppressWarnings("all")
  public FacebookType getContext() {
    return this.context;
  }

  /**
   * Social context for this person
   */
  @java.lang.SuppressWarnings("all")
  public void setContext(final FacebookType context) {
    this.context = context;
  }

  /**
   * The user's first name.
   * 
   * @return The user's first name.
   */
  @java.lang.SuppressWarnings("all")
  public String getFirstName() {
    return this.firstName;
  }

  /**
   * The user's first name.
   * 
   */
  @java.lang.SuppressWarnings("all")
  public void setFirstName(final String firstName) {
    this.firstName = firstName;
  }

  /**
   * The user's middle name.
   * 
   * @return The user's middle name.
   */
  @java.lang.SuppressWarnings("all")
  public String getMiddleName() {
    return this.middleName;
  }

  /**
   * The user's middle name.
   * 
   */
  @java.lang.SuppressWarnings("all")
  public void setMiddleName(final String middleName) {
    this.middleName = middleName;
  }

  /**
   * The person's name formatted to correctly handle Chinese, Japanese, or Korean ordering.
   *
   * @return The person's name formatted to correctly handle Chinese, Japanese, or Korean ordering
   */
  @java.lang.SuppressWarnings("all")
  public String getNameFormat() {
    return this.nameFormat;
  }

  /**
   * The person's name formatted to correctly handle Chinese, Japanese, or Korean ordering.
   */
  @java.lang.SuppressWarnings("all")
  public void setNameFormat(final String nameFormat) {
    this.nameFormat = nameFormat;
  }

  /**
   * The person's payment pricepoints
   *
   * @return The person's payment pricepoints
   */
  @java.lang.SuppressWarnings("all")
  public PaymentPricepoints getPaymentPricepoints() {
    return this.paymentPricepoints;
  }

  /**
   * The person's payment pricepoints
   */
  @java.lang.SuppressWarnings("all")
  public void setPaymentPricepoints(final PaymentPricepoints paymentPricepoints) {
    this.paymentPricepoints = paymentPricepoints;
  }

  /**
   * The user's last name.
   * 
   * @return The user's last name.
   */
  @java.lang.SuppressWarnings("all")
  public String getLastName() {
    return this.lastName;
  }

  /**
   * The user's last name.
   * 
   */
  @java.lang.SuppressWarnings("all")
  public void setLastName(final String lastName) {
    this.lastName = lastName;
  }

  /**
   * Shortened, locale-aware name for the person.
   *
   * @return Shortened, locale-aware name for the person
   */
  @GraphAPI(since = "2.9")
  @java.lang.SuppressWarnings("all")
  public String getShortName() {
    return this.shortName;
  }

  /**
   * Shortened, locale-aware name for the person.
   */
  @java.lang.SuppressWarnings("all")
  public void setShortName(final String shortName) {
    this.shortName = shortName;
  }

  /**
   * The person's cover photo
   *
   * @return The person's cover photo
   */
  @Override
  @java.lang.SuppressWarnings("all")
  public CoverPhoto getCover() {
    return this.cover;
  }

  /**
   * The person's cover photo
   */
  @java.lang.SuppressWarnings("all")
  public void setCover(final CoverPhoto cover) {
    this.cover = cover;
  }

  /**
   * A link to the person's Timeline.
   *
   * The link will only resolve if the person clicking the link is logged
   * into Facebook and is a friend of the person whose profile is being viewed.
   * 
   * @return A link to the user's profile.
   */
  @java.lang.SuppressWarnings("all")
  public String getLink() {
    return this.link;
  }

  /**
   * A link to the person's Timeline.
   *
   * The link will only resolve if the person clicking the link is logged
   * into Facebook and is a friend of the person whose profile is being viewed.
   * 
   */
  @java.lang.SuppressWarnings("all")
  public void setLink(final String link) {
    this.link = link;
  }

  /**
   * The user's biographical snippet.
   *
   * @return The user's biographical snippet.
   */
  @GraphAPI(until = "2.7")
  @java.lang.SuppressWarnings("all")
  public String getBio() {
    return this.bio;
  }

  /**
   * The user's biographical snippet.
   */
  @java.lang.SuppressWarnings("all")
  public void setBio(final String bio) {
    this.bio = bio;
  }

  /**
   * The user's favorite quotes.
   * 
   * @return The user's favorite quotes.
   */
  @java.lang.SuppressWarnings("all")
  public String getQuotes() {
    return this.quotes;
  }

  /**
   * The user's favorite quotes.
   * 
   */
  @java.lang.SuppressWarnings("all")
  public void setQuotes(final String quotes) {
    this.quotes = quotes;
  }

  /**
   * Unspecific age range that this person's age fits into.
   * 
   * @return The user's age range
   */
  @java.lang.SuppressWarnings("all")
  public AgeRange getAgeRange() {
    return this.ageRange;
  }

  /**
   * Unspecific age range that this person's age fits into.
   * 
   */
  @java.lang.SuppressWarnings("all")
  public void setAgeRange(final AgeRange ageRange) {
    this.ageRange = ageRange;
  }

  /**
   * The user's birthday as a {@code String}.
   * <p>
   * Will always succeed, even if the user has specified month/year format only.
   * If you'd like to use a typed version of this accessor,
   * call {@link #getBirthdayAsDate()} instead.
   *
   * "The person's birthday. This is a fixed format string, like `MM/DD/YYYY`.
   * However, people can control who can see the year they were
   * born separately from the month and day so this string can be
   * only the year (YYYY) or the month + day (MM/DD)",
   * 
   * @return The user's birthday as a {@code String}.
   */
  @java.lang.SuppressWarnings("all")
  public String getBirthday() {
    return this.birthday;
  }

  /**
   * The user's birthday as a {@code String}.
   * <p>
   * Will always succeed, even if the user has specified month/year format only.
   * If you'd like to use a typed version of this accessor,
   * call {@link #getBirthdayAsDate()} instead.
   *
   * "The person's birthday. This is a fixed format string, like `MM/DD/YYYY`.
   * However, people can control who can see the year they were
   * born separately from the month and day so this string can be
   * only the year (YYYY) or the month + day (MM/DD)",
   * 
   */
  @java.lang.SuppressWarnings("all")
  public void setBirthday(final String birthday) {
    this.birthday = birthday;
  }

  /**
   * The proxied or contact email address granted by the user.
   * 
   * @return The proxied or contact email address granted by the user.
   */
  @java.lang.SuppressWarnings("all")
  public String getEmail() {
    return this.email;
  }

  /**
   * The proxied or contact email address granted by the user.
   * 
   */
  @java.lang.SuppressWarnings("all")
  public void setEmail(final String email) {
    this.email = email;
  }

  /**
   * The user's timezone offset.
   * 
   * @return The user's timezone offset.
   */
  @java.lang.SuppressWarnings("all")
  public Double getTimezone() {
    return this.timezone;
  }

  /**
   * The user's timezone offset.
   * 
   */
  @java.lang.SuppressWarnings("all")
  public void setTimezone(final Double timezone) {
    this.timezone = timezone;
  }

  /**
   * Indicates whether the account has been verified. This is distinct from the <code>is_verified</code> field. Someone
   * is considered verified if they take any of the following actions:
   * <ul>
   * <li>Register for mobile</li>
   * <li>Confirm their account via SMS</li>
   * <li>Enter a valid credit card</li>
   * </ul>
   * 
   * @return User verification status.
   */
  @java.lang.SuppressWarnings("all")
  public Boolean getVerified() {
    return this.verified;
  }

  /**
   * Indicates whether the account has been verified. This is distinct from the <code>is_verified</code> field. Someone
   * is considered verified if they take any of the following actions:
   * <ul>
   * <li>Register for mobile</li>
   * <li>Confirm their account via SMS</li>
   * <li>Enter a valid credit card</li>
   * </ul>
   * 
   */
  @java.lang.SuppressWarnings("all")
  public void setVerified(final Boolean verified) {
    this.verified = verified;
  }

  /**
   * Video upload limits
   *
   * @return Video upload limits
   */
  @java.lang.SuppressWarnings("all")
  public VideoUploadLimits getVideoUploadLimits() {
    return this.videoUploadLimits;
  }

  /**
   * Video upload limits
   */
  @java.lang.SuppressWarnings("all")
  public void setVideoUploadLimits(final VideoUploadLimits videoUploadLimits) {
    this.videoUploadLimits = videoUploadLimits;
  }

  /**
   * The user's gender.
   * 
   * @return The user's gender.
   */
  @java.lang.SuppressWarnings("all")
  public String getGender() {
    return this.gender;
  }

  /**
   * The user's gender.
   * 
   */
  @java.lang.SuppressWarnings("all")
  public void setGender(final String gender) {
    this.gender = gender;
  }

  /**
   * The user's locale.
   * 
   * @return The user's locale.
   */
  @java.lang.SuppressWarnings("all")
  public String getLocale() {
    return this.locale;
  }

  /**
   * The user's locale.
   * 
   */
  @java.lang.SuppressWarnings("all")
  public void setLocale(final String locale) {
    this.locale = locale;
  }

  /**
   * The person's PGP public key
   *
   * @return The person's PGP public key
   */
  @java.lang.SuppressWarnings("all")
  public String getPublicKey() {
    return this.publicKey;
  }

  /**
   * The person's PGP public key
   */
  @java.lang.SuppressWarnings("all")
  public void setPublicKey(final String publicKey) {
    this.publicKey = publicKey;
  }

  /**
   * The user's Likes
   *
   * @return the user's Likes
   */
  @java.lang.SuppressWarnings("all")
  public Likes getLikes() {
    return this.likes;
  }

  /**
   * The user's Likes
   */
  @java.lang.SuppressWarnings("all")
  public void setLikes(final Likes likes) {
    this.likes = likes;
  }

  /**
   * The user's picture, if provided.
   * 
   * To force Facebook to fill the <code>picture</code> field you have to fetch the user with the
   * <code>fields=picture</code> parameter, otherwise the picture is <code>null</code>.
   * 
   * @return the user's picture as ProfilePictureSource object
   * @since 1.6.16
   */
  @Override
  @java.lang.SuppressWarnings("all")
  public ProfilePictureSource getPicture() {
    return this.picture;
  }

  /**
   * The user's picture, if provided.
   * 
   * To force Facebook to fill the <code>picture</code> field you have to fetch the user with the
   * <code>fields=picture</code> parameter, otherwise the picture is <code>null</code>.
   * 
   * @since 1.6.16
   */
  @java.lang.SuppressWarnings("all")
  public void setPicture(final ProfilePictureSource picture) {
    this.picture = picture;
  }

  /**
   * Duplicate mapping for "hometown" since FB can return it differently in different situations.
   * 
   * -- GETTER -- The user's hometown.
   * <p>
   * Sometimes this can be {@code null} - check {@link #getHometownName()} instead in that case.
   * 
   * @return The user's hometown.
   */
  @java.lang.SuppressWarnings("all")
  public NamedFacebookType getHometown() {
    return this.hometown;
  }

  /**
   * Duplicate mapping for "hometown" since FB can return it differently in different situations.
   * 
   * -- GETTER -- The user's hometown.
   * <p>
   * Sometimes this can be {@code null} - check {@link #getHometownName()} instead in that case.
   * 
   */
  @java.lang.SuppressWarnings("all")
  public void setHometown(final NamedFacebookType hometown) {
    this.hometown = hometown;
  }

  /**
   * A profile based app scoped ID. It is used to query avatars
   */
  @java.lang.SuppressWarnings("all")
  public String getIdForAvatars() {
    return this.idForAvatars;
  }

  /**
   * A profile based app scoped ID. It is used to query avatars
   */
  @java.lang.SuppressWarnings("all")
  public void setIdForAvatars(final String idForAvatars) {
    this.idForAvatars = idForAvatars;
  }

  /**
   * he person's current location as entered by them on their profile.
   *
   * This field requires the `user_location` permission.
   *
   * @return The user's current location.
   */
  @java.lang.SuppressWarnings("all")
  public NamedFacebookType getLocation() {
    return this.location;
  }

  /**
   * he person's current location as entered by them on their profile.
   *
   * This field requires the `user_location` permission.
   */
  @java.lang.SuppressWarnings("all")
  public void setLocation(final NamedFacebookType location) {
    this.location = location;
  }

  /**
   * The time that the shared loginneeds to be upgraded to Business Manager by
   *
   * @return The time that the shared loginneeds to be upgraded to Business Manager by
   */
  @java.lang.SuppressWarnings("all")
  public Date getSharedLoginUpgradeRequiredBy() {
    return this.sharedLoginUpgradeRequiredBy;
  }

  /**
   * The time that the shared loginneeds to be upgraded to Business Manager by
   */
  @java.lang.SuppressWarnings("all")
  public void setSharedLoginUpgradeRequiredBy(final Date sharedLoginUpgradeRequiredBy) {
    this.sharedLoginUpgradeRequiredBy = sharedLoginUpgradeRequiredBy;
  }

  /**
   * The user's significant other.
   * 
   * @return The user's significant other.
   */
  @java.lang.SuppressWarnings("all")
  public User getSignificantOther() {
    return this.significantOther;
  }

  /**
   * The user's significant other.
   * 
   */
  @java.lang.SuppressWarnings("all")
  public void setSignificantOther(final User significantOther) {
    this.significantOther = significantOther;
  }

  /**
   * Whether the user can add a Donate Button to their Live Videos
   */
  @java.lang.SuppressWarnings("all")
  public Boolean getSupportsDonateButtonInLiveVideo() {
    return this.supportsDonateButtonInLiveVideo;
  }

  /**
   * Whether the user can add a Donate Button to their Live Videos
   */
  @java.lang.SuppressWarnings("all")
  public void setSupportsDonateButtonInLiveVideo(final Boolean supportsDonateButtonInLiveVideo) {
    this.supportsDonateButtonInLiveVideo = supportsDonateButtonInLiveVideo;
  }

  /**
   * Date the user's profile was updated.
   * 
   * @return Date the user's profile was updated.
   */
  @java.lang.SuppressWarnings("all")
  public Date getUpdatedTime() {
    return this.updatedTime;
  }

  /**
   * Date the user's profile was updated.
   * 
   */
  @java.lang.SuppressWarnings("all")
  public void setUpdatedTime(final Date updatedTime) {
    this.updatedTime = updatedTime;
  }

  /**
   * An anonymous, but unique identifier for the user.
   * 
   * @return An anonymous, but unique identifier for the user.
   */
  @java.lang.SuppressWarnings("all")
  public String getThirdPartyId() {
    return this.thirdPartyId;
  }

  /**
   * An anonymous, but unique identifier for the user.
   * 
   */
  @java.lang.SuppressWarnings("all")
  public void setThirdPartyId(final String thirdPartyId) {
    this.thirdPartyId = thirdPartyId;
  }

  /**
   * The user's currency preferences.
   * <p>
   * Further documentation available on Facebook's
   * <a href="https://developers.facebook.com/docs/payments/user_currency">Displaying prices in user's currency</a>
   * page.
   * 
   * @return The user's currency preferences.
   * @since 1.6.12
   */
  @java.lang.SuppressWarnings("all")
  public Currency getCurrency() {
    return this.currency;
  }

  /**
   * The user's currency preferences.
   * <p>
   * Further documentation available on Facebook's
   * <a href="https://developers.facebook.com/docs/payments/user_currency">Displaying prices in user's currency</a>
   * page.
   * 
   * @since 1.6.12
   */
  @java.lang.SuppressWarnings("all")
  public void setCurrency(final Currency currency) {
    this.currency = currency;
  }

  /**
   * This returns a string which is the same for this person across all the apps managed by the same Business Manager.
   * 
   * @return string which is the same for a person across all apps managed by one company
   * @since 1.7.0
   */
  @java.lang.SuppressWarnings("all")
  public String getTokenForBusiness() {
    return this.tokenForBusiness;
  }

  /**
   * This returns a string which is the same for this person across all the apps managed by the same Business Manager.
   * 
   * @since 1.7.0
   */
  @java.lang.SuppressWarnings("all")
  public void setTokenForBusiness(final String tokenForBusiness) {
    this.tokenForBusiness = tokenForBusiness;
  }

  /**
   * Install type.
   *
   * @return Install type.
   */
  @java.lang.SuppressWarnings("all")
  public String getInstallType() {
    return this.installType;
  }

  /**
   * Install type.
   */
  @java.lang.SuppressWarnings("all")
  public void setInstallType(final String installType) {
    this.installType = installType;
  }

  /**
   * Is the app making the request installed?
   *
   * @return Is the app making the request installed?
   */
  @java.lang.SuppressWarnings("all")
  public Boolean getInstalled() {
    return this.installed;
  }

  /**
   * Is the app making the request installed?
   */
  @java.lang.SuppressWarnings("all")
  public void setInstalled(final Boolean installed) {
    this.installed = installed;
  }

  /**
   * People with large numbers of followers can have the authenticity of their identity manually verified by Facebook.
   * This field indicates whether the person's profile is verified in this way.
   *
   * This is distinct from the <code>verified</code> field
   *
   * @return Is the user verified
   */
  @java.lang.SuppressWarnings("all")
  public Boolean getIsVerified() {
    return this.isVerified;
  }

  /**
   * People with large numbers of followers can have the authenticity of their identity manually verified by Facebook.
   * This field indicates whether the person's profile is verified in this way.
   *
   * This is distinct from the <code>verified</code> field
   */
  @java.lang.SuppressWarnings("all")
  public void setIsVerified(final Boolean isVerified) {
    this.isVerified = isVerified;
  }

  @java.lang.SuppressWarnings("all")
  public Boolean getIsWorkAccount() {
    return this.isWorkAccount;
  }

  @java.lang.SuppressWarnings("all")
  public void setIsWorkAccount(final Boolean isWorkAccount) {
    this.isWorkAccount = isWorkAccount;
  }

  /**
   * if the current user is a guest user. should always return false.
   */
  @java.lang.SuppressWarnings("all")
  public Boolean getIsGuestUser() {
    return this.isGuestUser;
  }

  /**
   * if the current user is a guest user. should always return false.
   */
  @java.lang.SuppressWarnings("all")
  public void setIsGuestUser(final Boolean isGuestUser) {
    this.isGuestUser = isGuestUser;
  }
}