HaiwaiAdv1/NatureSDK/Pods/FacebookCore/Sources/Core/Permission.swift

// Copyright (c) 2016-present, Facebook, Inc. All rights reserved.
//
// You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
// copy, modify, and distribute this software in source code or binary form for use
// in connection with the web services and APIs provided by Facebook.
//
// As with any software that integrates with the Facebook platform, your use of
// this software is subject to the Facebook Developer Principles and Policies
// [http://developers.facebook.com/policy/]. This copyright 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.

import Foundation

/**
 Represents a Graph API permission.
 Each permission has its own set of requirements and suggested use cases.
 See a full list at https://developers.facebook.com/docs/facebook-login/permissions
 */
public enum Permission: Hashable, ExpressibleByStringLiteral {
  /// Provides access to a subset of items that are part of a person's public profile.
  case publicProfile
  /// Provides access the list of friends that also use your app.
  case userFriends
  /// Provides access to the person's primary email address.
  case email
  /// Provides access to a person's personal description (the 'About Me' section on their Profile)
  case userAboutMe
  /// Provides access to all common books actions published by any app the person has used.
  /// This includes books they've read, want to read, rated or quoted.
  case userActionsBooks
  /// Provides access to all common Open Graph fitness actions published by any app the person has used.
  /// This includes runs, walks and bikes actions.
  case userActionsFitness
  /// Provides access to all common Open Graph music actions published by any app the person has used.
  /// This includes songs they've listened to, and playlists they've created.
  case userActionsMusic
  /// Provides access to all common Open Graph news actions published by any app the person
  /// has used which publishes these actions.
  /// This includes news articles they've read or news articles they've published.
  case userActionsNews
  /// Provides access to all common Open Graph video actions published by any app the person
  /// has used which publishes these actions.
  case userActionsVideo
  /// Access the date and month of a person's birthday. This may or may not include the person's year of birth,
  /// dependent upon their privacy settings and the access token being used to query this field.
  case userBirthday
  /// Provides access to a person's education history through the education field on the User object.
  case userEducationHistory
  /// Provides read-only access to the Events a person is hosting or has RSVP'd to.
  case userEvents
  /// Provides access to read a person's game activity (scores, achievements) in any game the person has played.
  case userGamesActivity
  /// Provides access to a person's gender.
  case userGender
  /// Provides access to a person's hometown location through the hometown field on the User object.
  case userHometown
  /// Provides access to the list of all Facebook Pages and Open Graph objects that a person has liked.
  case userLikes
  /// Provides access to a person's current city through the location field on the User object.
  case userLocation
  /// Lets your app read the content of groups a person is an admin of through the Groups edge on the User object.
  case userManagedGroups
  /// Provides access to the photos a person has uploaded or been tagged in.
  case userPhotos
  /// Provides access to the posts on a person's Timeline. Includes their own posts, posts they are tagged in,
  /// and posts other people make on their Timeline.
  case userPosts
  /// Provides access to a person's relationship status,
  /// significant other and family members as fields on the User object.
  case userRelationships
  /// Provides access to a person's relationship interests as the interested_in field on the User object.
  case userRelationshipDetails
  /// Provides access to a person's religious and political affiliations.
  case userReligionPolitics
  /// Provides access to the Places a person has been tagged at in photos, videos, statuses and links.
  case userTaggedPlaces
  /// Provides access to the videos a person has uploaded or been tagged in.
  case userVideos
  /// Provides access to the person's personal website URL via the website field on the User object.
  case userWebsite
  /// Provides access to a person's work history and list of employers via the work field on the User object.
  case userWorkHistory
  /// Provides access to the names of custom lists a person has created to organize their friends.
  case readCustomFriendlists
  /// Provides read-only access to the Insights data for Pages, Apps and web domains the person owns.
  case readInsights
  /// Provides read-only access to the Audience Network Insights data for Apps the person owns.
  case readAudienceNetworkInsights
  /// Provides the ability to read from the Page Inboxes of the Pages managed by a person.
  case readPageMailboxes
  /// Provides the access to show the list of the Pages that you manage.
  case pagesShowList
  /// Provides the access to manage call to actions of the Pages that you manage.
  case pagesManageCta
  /// Lets your app manage Instant Articles on behalf of Facebook Pages administered by people using your app.
  case pagesManageInstantArticles
  /// Provides the access to Ads Insights API to pull ads report information for ad accounts you have access to.
  case adsRead
  /**
   Permission with a custom string value.
   See https://developers.facebook.com/docs/facebook-login/permissions for full list of available permissions.
   */
  case custom(String)

  public init(stringLiteral value: String) {
    guard let permission = StringPermission(rawValue: value)?.permission else {
      self = .custom(value)
      return
    }

    self = permission
  }

  public var name: String {
    if let permission = stringPermission {
      return permission.rawValue
    }

    if case let .custom(permission) = self {
      return permission
    }

    return ""
  }

  private var stringPermission: StringPermission? {
    switch self {
    case .publicProfile: return .publicProfile
    case .userFriends: return .userFriends
    case .email: return .email
    case .userAboutMe: return .userAboutMe
    case .userActionsBooks: return .userActionsBooks
    case .userActionsFitness: return .userActionsFitness
    case .userActionsMusic: return .userActionsMusic
    case .userActionsNews: return .userActionsNews
    case .userActionsVideo: return .userActionsVideo
    case .userBirthday: return .userBirthday
    case .userEducationHistory: return .userEducationHistory
    case .userEvents: return .userEvents
    case .userGamesActivity: return .userGamesActivity
    case .userGender: return .userGender
    case .userHometown: return .userHometown
    case .userLikes: return .userLikes
    case .userLocation: return .userLocation
    case .userManagedGroups: return .userManagedGroups
    case .userPhotos: return .userPhotos
    case .userPosts: return .userPosts
    case .userRelationships: return .userRelationships
    case .userRelationshipDetails: return .userRelationshipDetails
    case .userReligionPolitics: return .userReligionPolitics
    case .userTaggedPlaces: return .userTaggedPlaces
    case .userVideos: return .userVideos
    case .userWebsite: return .userWebsite
    case .userWorkHistory: return .userWorkHistory
    case .readCustomFriendlists: return .readCustomFriendlists
    case .readInsights: return .readInsights
    case .readAudienceNetworkInsights: return .readAudienceNetworkInsights
    case .readPageMailboxes: return .readPageMailboxes
    case .pagesShowList: return .pagesShowList
    case .pagesManageCta: return .pagesManageCta
    case .pagesManageInstantArticles: return .pagesManageInstantArticles
    case .adsRead: return .adsRead
    case .custom: return nil
    }
  }
}

private enum StringPermission: String {
  case publicProfile = "public_profile"
  case userFriends = "user_friends"
  case email = "email"
  case userAboutMe = "user_about_me"
  case userActionsBooks = "user_actions.books"
  case userActionsFitness = "user_action.fitness"
  case userActionsMusic = "user_actions.music"
  case userActionsNews = "user_actions.news"
  case userActionsVideo = "user_actions.video"
  case userBirthday = "user_birthday"
  case userEducationHistory = "user_education_history"
  case userEvents = "user_events"
  case userGamesActivity = "user_games_activity"
  case userGender = "user_gender"
  case userHometown = "user_hometown"
  case userLikes = "user_likes"
  case userLocation = "user_location"
  case userManagedGroups = "user_managed_groups"
  case userPhotos = "user_photos"
  case userPosts = "user_posts"
  case userRelationships = "user_relationships"
  case userRelationshipDetails = "user_relationship_details"
  case userReligionPolitics = "user_religion_politics"
  case userTaggedPlaces = "user_tagged_places"
  case userVideos = "user_videos"
  case userWebsite = "user_website"
  case userWorkHistory = "user_work_history"
  case readCustomFriendlists = "read_custom_friendlists"
  case readInsights = "read_insights"
  case readAudienceNetworkInsights = "read_audience_network_insights"
  case readPageMailboxes = "read_page_mailboxes"
  case pagesShowList = "pages_show_list"
  case pagesManageCta = "pages_manage_cta"
  case pagesManageInstantArticles = "pages_manage_instant_articles"
  case adsRead = "ads_read"

  var permission: Permission {
    switch self {
    case .publicProfile: return .publicProfile
    case .userFriends: return .userFriends
    case .email: return .email
    case .userAboutMe: return .userAboutMe
    case .userActionsBooks: return .userActionsBooks
    case .userActionsFitness: return .userActionsFitness
    case .userActionsMusic: return .userActionsMusic
    case .userActionsNews: return .userActionsNews
    case .userActionsVideo: return .userActionsVideo
    case .userBirthday: return .userBirthday
    case .userEducationHistory: return .userEducationHistory
    case .userEvents: return .userEvents
    case .userGamesActivity: return .userGamesActivity
    case .userGender: return .userGender
    case .userHometown: return .userHometown
    case .userLikes: return .userLikes
    case .userLocation: return .userLocation
    case .userManagedGroups: return .userManagedGroups
    case .userPhotos: return .userPhotos
    case .userPosts: return .userPosts
    case .userRelationships: return .userRelationships
    case .userRelationshipDetails: return .userRelationshipDetails
    case .userReligionPolitics: return .userReligionPolitics
    case .userTaggedPlaces: return .userTaggedPlaces
    case .userVideos: return .userVideos
    case .userWebsite: return .userWebsite
    case .userWorkHistory: return .userWorkHistory
    case .readCustomFriendlists: return .readCustomFriendlists
    case .readInsights: return .readInsights
    case .readAudienceNetworkInsights: return .readAudienceNetworkInsights
    case .readPageMailboxes: return .readPageMailboxes
    case .pagesShowList: return .pagesShowList
    case .pagesManageCta: return .pagesManageCta
    case .pagesManageInstantArticles: return .pagesManageInstantArticles
    case .adsRead: return .adsRead
    }
  }
}