From e0ec4235cc7b8d05ec1aaa414ec2d2cac798d74e Mon Sep 17 00:00:00 2001 From: lpw Date: Sat, 03 Jun 2023 09:18:20 +0800 Subject: [PATCH] 3.15.0 --- frameworks/FBSDKLoginKit.xcframework/ios-arm64_x86_64-maccatalyst/FBSDKLoginKit.framework/Headers/FBSDKLoginKit-Swift.h | 1350 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 files changed, 1,348 insertions(+), 2 deletions(-) diff --git a/frameworks/FBSDKLoginKit.xcframework/ios-arm64_x86_64-maccatalyst/FBSDKLoginKit.framework/Headers/FBSDKLoginKit-Swift.h b/frameworks/FBSDKLoginKit.xcframework/ios-arm64_x86_64-maccatalyst/FBSDKLoginKit.framework/Headers/FBSDKLoginKit-Swift.h index c4c6bbc..165902d 100644 --- a/frameworks/FBSDKLoginKit.xcframework/ios-arm64_x86_64-maccatalyst/FBSDKLoginKit.framework/Headers/FBSDKLoginKit-Swift.h +++ b/frameworks/FBSDKLoginKit.xcframework/ios-arm64_x86_64-maccatalyst/FBSDKLoginKit.framework/Headers/FBSDKLoginKit-Swift.h @@ -1,6 +1,6 @@ #if 0 #elif defined(__arm64__) && __arm64__ -// Generated by Apple Swift version 5.4 (swiftlang-1205.0.26.9 clang-1205.0.19.55) +// Generated by Apple Swift version 5.7.2 (swiftlang-5.7.2.135.5 clang-1400.0.29.51) #ifndef FBSDKLOGINKIT_SWIFT_H #define FBSDKLOGINKIT_SWIFT_H #pragma clang diagnostic push @@ -23,11 +23,20 @@ # include <swift/objc-prologue.h> #endif +#pragma clang diagnostic ignored "-Wduplicate-method-match" #pragma clang diagnostic ignored "-Wauto-import" +#if defined(__OBJC__) #include <Foundation/Foundation.h> +#endif +#if defined(__cplusplus) +#include <cstdint> +#include <cstddef> +#include <cstdbool> +#else #include <stdint.h> #include <stddef.h> #include <stdbool.h> +#endif #if !defined(SWIFT_TYPEDEFS) # define SWIFT_TYPEDEFS 1 @@ -183,15 +192,54 @@ #else # define SWIFT_DEPRECATED_OBJC(Msg) SWIFT_DEPRECATED_MSG(Msg) #endif +#if defined(__OBJC__) #if !defined(IBSegueAction) # define IBSegueAction #endif +#endif +#if !defined(SWIFT_EXTERN) +# if defined(__cplusplus) +# define SWIFT_EXTERN extern "C" +# else +# define SWIFT_EXTERN extern +# endif +#endif +#if !defined(SWIFT_CALL) +# define SWIFT_CALL __attribute__((swiftcall)) +#endif +#if defined(__cplusplus) +#if !defined(SWIFT_NOEXCEPT) +# define SWIFT_NOEXCEPT noexcept +#endif +#else +#if !defined(SWIFT_NOEXCEPT) +# define SWIFT_NOEXCEPT +#endif +#endif +#if defined(__cplusplus) +#if !defined(SWIFT_CXX_INT_DEFINED) +#define SWIFT_CXX_INT_DEFINED +namespace swift { +using Int = ptrdiff_t; +using UInt = size_t; +} +#endif +#endif +#if defined(__OBJC__) #if __has_feature(modules) #if __has_warning("-Watimport-in-framework-header") #pragma clang diagnostic ignored "-Watimport-in-framework-header" #endif +@import CoreFoundation; +@import FBSDKCoreKit; +@import Foundation; +@import ObjectiveC; +@import UIKit; #endif +#import <FBSDKLoginKit/FBSDKLoginKit.h> + +#endif #pragma clang diagnostic ignored "-Wproperty-attribute-mismatch" #pragma clang diagnostic ignored "-Wduplicate-method-arg" #if __has_warning("-Wpragma-clang-attribute") @@ -199,6 +247,7 @@ #endif #pragma clang diagnostic ignored "-Wunknown-pragmas" #pragma clang diagnostic ignored "-Wnullability" +#pragma clang diagnostic ignored "-Wdollar-in-identifier-extension" #if __has_attribute(external_source_symbol) # pragma push_macro("any") @@ -207,9 +256,632 @@ # pragma pop_macro("any") #endif +#if defined(__OBJC__) + +@class NSString; + +/// Represents a code verifier used in the PKCE (Proof Key for Code Exchange) +/// process. This is a cryptographically random string using the characters +/// A-Z, a-z, 0-9, and the punctuation characters -._~ (hyphen, period, +/// underscore, and tilde), between 43 and 128 characters long. +SWIFT_CLASS_NAMED("CodeVerifier") +@interface FBSDKCodeVerifier : NSObject +/// The string value of the code verifier +@property (nonatomic, readonly, copy) NSString * _Nonnull value; +/// The SHA256 hashed challenge of the code verifier +@property (nonatomic, readonly, copy) NSString * _Nonnull challenge; +/// Attempts to initialize a new code verifier instance with the given string. +/// Creation will fail and return nil if the string is invalid. +/// @param string the code verifier string +- (nullable instancetype)initWithString:(NSString * _Nonnull)string; +/// Initializes a new code verifier instance with a random string value +- (nonnull instancetype)init; +@end + +/// Passed to openURL to indicate which default audience to use for sessions that post data to Facebook. +/// Certain operations such as publishing a status or publishing a photo require an audience. When the user +/// grants an application permission to perform a publish operation, a default audience is selected as the +/// publication ceiling for the application. This enumerated value allows the application to select which +/// audience to ask the user to grant publish permission for. +typedef SWIFT_ENUM_NAMED(NSUInteger, FBSDKDefaultAudience, "DefaultAudience", open) { +/// Indicates that the user’s friends are able to see posts made by the application + FBSDKDefaultAudienceFriends = 0, +/// Indicates that only the user is able to see posts made by the application + FBSDKDefaultAudienceOnlyMe = 1, +/// Indicates that all Facebook users are able to see posts made by the application + FBSDKDefaultAudienceEveryone = 2, +}; + +@class NSURL; +@class NSDate; + +/// Describes the initial response when starting the device login flow. +/// This is used by <code>DeviceLoginManager</code>. +SWIFT_CLASS_NAMED("DeviceLoginCodeInfo") +@interface FBSDKDeviceLoginCodeInfo : NSObject +/// The unique id for this login flow. +@property (nonatomic, readonly, copy) NSString * _Nonnull identifier; +/// The short “user_code” that should be presented to the user. +@property (nonatomic, readonly, copy) NSString * _Nonnull loginCode; +/// The verification URL. +@property (nonatomic, readonly, copy) NSURL * _Nonnull verificationURL; +/// The expiration date. +@property (nonatomic, readonly, copy) NSDate * _Nonnull expirationDate; +/// The polling interval +@property (nonatomic, readonly) NSUInteger pollingInterval; +- (nonnull instancetype)initWithIdentifier:(NSString * _Nonnull)identifier loginCode:(NSString * _Nonnull)loginCode verificationURL:(NSURL * _Nonnull)verificationURL expirationDate:(NSDate * _Nonnull)expirationDate pollingInterval:(NSUInteger)pollingInterval OBJC_DESIGNATED_INITIALIZER; +- (nonnull instancetype)init SWIFT_UNAVAILABLE; ++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable"); +@end + +/// Custom error codes for device login errors in the login error domain +typedef SWIFT_ENUM_NAMED(NSInteger, FBSDKDeviceLoginError, "DeviceLoginErrorCode", open) { +/// Your device is polling too frequently. + FBSDKDeviceLoginErrorExcessivePolling = 1349172, +/// User has declined to authorize your application. + FBSDKDeviceLoginErrorAuthorizationDeclined = 1349173, +/// User has not yet authorized your application. Continue polling. + FBSDKDeviceLoginErrorAuthorizationPending = 1349174, +/// The code you entered has expired. + FBSDKDeviceLoginErrorCodeExpired = 1349152, +}; + +@protocol FBSDKDeviceLoginManagerDelegate; + +/// Use this class to perform a device login flow. +/// The device login flow starts by requesting a code from the device login API. +/// This class informs the delegate when this code is received. You should then present the +/// code to the user to enter. In the meantime, this class polls the device login API +/// periodically and informs the delegate of the results. +/// See <a href="https://developers.facebook.com/docs/facebook-login/for-devices">Facebook Device Login</a>. +SWIFT_CLASS_NAMED("DeviceLoginManager") +@interface FBSDKDeviceLoginManager : NSObject +/// The device login manager delegate. +@property (nonatomic, weak) id <FBSDKDeviceLoginManagerDelegate> _Nullable delegate; +/// The requested permissions. +@property (nonatomic, readonly, copy) NSArray<NSString *> * _Nonnull permissions; +/// The optional URL to redirect the user to after they complete the login. +/// The URL must be configured in your App Settings -> Advanced -> OAuth Redirect URIs +@property (nonatomic, copy) NSURL * _Nullable redirectURL; +/// Initializes a new instance. +/// @param permissions The permissions to request. +/// @param enableSmartLogin Whether to enable smart login. +- (nonnull instancetype)initWithPermissions:(NSArray<NSString *> * _Nonnull)permissions enableSmartLogin:(BOOL)enableSmartLogin OBJC_DESIGNATED_INITIALIZER; +/// Starts the device login flow +/// This instance will retain self until the flow is finished or cancelled. +- (void)start; +/// Attempts to cancel the device login flow. +- (void)cancel; +- (nonnull instancetype)init SWIFT_UNAVAILABLE; ++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable"); +@end + +@class NSNetService; +@class NSNumber; + +@interface FBSDKDeviceLoginManager (SWIFT_EXTENSION(FBSDKLoginKit)) <NSNetServiceDelegate> +- (void)netService:(NSNetService * _Nonnull)service didNotPublish:(NSDictionary<NSString *, NSNumber *> * _Nonnull)errorValues; +@end + + +@class FBSDKDeviceLoginManagerResult; + +/// A delegate for <code>DeviceLoginManager</code>. +SWIFT_PROTOCOL_NAMED("DeviceLoginManagerDelegate") +@protocol FBSDKDeviceLoginManagerDelegate +/// Indicates the device login flow has started. You should parse <code>codeInfo</code> to present the code to the user to enter. +/// @param loginManager the login manager instance. +/// @param codeInfo the code info data. +- (void)deviceLoginManager:(FBSDKDeviceLoginManager * _Nonnull)loginManager startedWithCodeInfo:(FBSDKDeviceLoginCodeInfo * _Nonnull)codeInfo; +/// Indicates the device login flow has finished. +/// @param loginManager the login manager instance. +/// @param result the results of the login flow. +/// @param error the error, if available. +/// The flow can be finished if the user completed the flow, cancelled, or if the code has expired. +- (void)deviceLoginManager:(FBSDKDeviceLoginManager * _Nonnull)loginManager completedWithResult:(FBSDKDeviceLoginManagerResult * _Nullable)result error:(NSError * _Nullable)error; +@end + +@class FBSDKAccessToken; + +/// Represents the results of the a device login flow. This is used by <code>DeviceLoginManager</code> +SWIFT_CLASS_NAMED("DeviceLoginManagerResult") +@interface FBSDKDeviceLoginManagerResult : NSObject +/// The token +@property (nonatomic, readonly, strong) FBSDKAccessToken * _Nullable accessToken; +/// Indicates if the login was cancelled by the user, or if the device login code has expired. +@property (nonatomic, readonly) BOOL isCancelled; +/// Internal method exposed to facilitate transition to Swift. +/// API Subject to change or removal without warning. Do not use. +/// @warning INTERNAL - DO NOT USE +- (nonnull instancetype)initWithToken:(FBSDKAccessToken * _Nullable)token isCancelled:(BOOL)cancelled OBJC_DESIGNATED_INITIALIZER; +- (nonnull instancetype)init SWIFT_UNAVAILABLE; ++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable"); +@end + +@protocol FBSDKLoginButtonDelegate; +enum FBSDKLoginButtonTooltipBehavior : NSUInteger; +enum FBSDKTooltipColorStyle : NSUInteger; +enum FBSDKLoginTracking : NSUInteger; +@class NSCoder; + +/// A button that initiates a log in or log out flow upon tapping. +/// <code>LoginButton</code> works with <code>AccessToken.current</code> to determine what to display, +/// and automatically starts authentication when tapped (i.e., you do not need to manually subscribe action targets). +/// Like <code>LoginManager</code>, you should make sure your app delegate is connected to <code>ApplicationDelegate</code> +/// in order for the button’s delegate to receive messages. +/// <code>LoginButton</code> has a fixed height of 30 pixels, but you may change the width. +/// Initializing the button with <code>nil</code> frame will size the button to its minimum frame. +SWIFT_CLASS_NAMED("FBLoginButton") +@interface FBSDKLoginButton : FBSDKButton +/// The default audience to use, if publish permissions are requested at login time. +@property (nonatomic) enum FBSDKDefaultAudience defaultAudience; +/// Gets or sets the delegate. +@property (nonatomic, weak) IBOutlet id <FBSDKLoginButtonDelegate> _Nullable delegate; +/// The permissions to request. +/// To provide the best experience, you should minimize the number of permissions you request, and only ask for them when needed. +/// For example, do not ask for “user_location” until you the information is actually used by the app. +/// Note this is converted to NSSet and is only +/// an NSArray for the convenience of literal syntax. +/// See <a href="https://developers.facebook.com/docs/facebook-login/permissions/">the permissions guide</a> for more details. +@property (nonatomic, copy) NSArray<NSString *> * _Nonnull permissions; +/// Gets or sets the desired tooltip behavior. +@property (nonatomic) enum FBSDKLoginButtonTooltipBehavior tooltipBehavior; +/// Gets or sets the desired tooltip color style. +@property (nonatomic) enum FBSDKTooltipColorStyle tooltipColorStyle; +/// Gets or sets the desired tracking preference to use for login attempts. Defaults to <code>.enabled</code> +@property (nonatomic) enum FBSDKLoginTracking loginTracking; +/// Gets or sets an optional nonce to use for login attempts. A valid nonce must be a non-empty string without whitespace. +/// An invalid nonce will not be set. Instead, default unique nonces will be used for login attempts. +@property (nonatomic, copy) NSString * _Nullable nonce; +/// Gets or sets an optional page id to use for login attempts. +@property (nonatomic, copy) NSString * _Nullable messengerPageId; +/// Gets or sets the login authorization type to use in the login request. Defaults to <code>rerequest</code>. Use <code>nil</code> to avoid +/// requesting permissions that were previously denied. +@property (nonatomic) FBSDKLoginAuthType _Nullable authType; +/// The code verifier used in the PKCE process. +/// If not provided, a code verifier will be randomly generated. +@property (nonatomic, strong) FBSDKCodeVerifier * _Nonnull codeVerifier; +- (nonnull instancetype)initWithFrame:(CGRect)frame OBJC_DESIGNATED_INITIALIZER; +- (nullable instancetype)initWithCoder:(NSCoder * _Nonnull)coder SWIFT_UNAVAILABLE; +- (void)didMoveToWindow; +- (CGRect)imageRectForContentRect:(CGRect)contentRect SWIFT_WARN_UNUSED_RESULT; +- (CGRect)titleRectForContentRect:(CGRect)contentRect SWIFT_WARN_UNUSED_RESULT; +- (void)layoutSubviews; +- (CGSize)sizeThatFits:(CGSize)size SWIFT_WARN_UNUSED_RESULT; +@end + +/// Indicates the desired login tooltip behavior. +typedef SWIFT_ENUM_NAMED(NSUInteger, FBSDKLoginButtonTooltipBehavior, "TooltipBehavior", open) { +/// The default behavior. The tooltip will only be displayed if +/// the app is eligible (determined by possible server round trip) + FBSDKLoginButtonTooltipBehaviorAutomatic = 0, +/// Force display of the tooltip (typically for UI testing) + FBSDKLoginButtonTooltipBehaviorForceDisplay = 1, +/// Force disable. In this case you can still exert more refined +/// control by manually constructing a <code>FBSDKLoginTooltipView</code> instance. + FBSDKLoginButtonTooltipBehaviorDisable = 2, +}; + +enum FBSDKTooltipViewArrowDirection : NSUInteger; + +/// Tooltip bubble with text in it used to display tips for UI elements, +/// with a pointed arrow (to refer to the UI element). +/// The tooltip fades in and will automatically fade out. See <code>displayDuration</code>. +SWIFT_CLASS_NAMED("FBTooltipView") +@interface FBSDKTooltipView : UIView +/// Gets or sets the amount of time in seconds the tooltip should be displayed. +/// Set this to zero to make the display permanent until explicitly dismissed. +/// Defaults to six seconds. +@property (nonatomic) NSTimeInterval displayDuration; +/// Gets or sets the color style after initialization. +/// Defaults to value passed to -initWithTagline:message:colorStyle:. +@property (nonatomic) enum FBSDKTooltipColorStyle colorStyle; +/// Gets or sets the message. +@property (nonatomic, copy) NSString * _Nullable message; +/// Gets or sets the optional phrase that comprises the first part of the label (and is highlighted differently). +@property (nonatomic, copy) NSString * _Nullable tagline; +/// Convenience constructor +- (nonnull instancetype)init SWIFT_UNAVAILABLE; ++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable"); +/// Designated initializer. +/// If you need to show a tooltip for login, consider using the <code>FBSDKLoginTooltipView</code> view. +/// See FBSDKLoginTooltipView +/// \param tagline First part of the label, that will be highlighted with different color. Can be nil. +/// +/// \param message Main message to display. +/// +/// \param colorStyle Color style to use for tooltip. +/// +- (nonnull instancetype)initWithTagline:(NSString * _Nullable)tagline message:(NSString * _Nullable)message colorStyle:(enum FBSDKTooltipColorStyle)colorStyle OBJC_DESIGNATED_INITIALIZER; +- (nullable instancetype)initWithCoder:(NSCoder * _Nonnull)coder OBJC_DESIGNATED_INITIALIZER SWIFT_UNAVAILABLE; +/// Show tooltip at the top or at the bottom of given view. +/// Tooltip will be added to anchorView.window.rootViewController.view +/// Use this method to present the tooltip with automatic positioning or +/// use -presentInView:withArrowPosition:direction: for manual positioning +/// If anchorView is nil or has no window - this method does nothing. +/// \param anchorView view to show at, must be already added to window view hierarchy, in order to decide +/// where tooltip will be shown. (If there’s not enough space at the top of the anchorView in window bounds - +/// tooltip will be shown at the bottom of it) +/// +- (void)presentFromView:(UIView * _Nonnull)anchorView; +/// Adds tooltip to given view, with given position and arrow direction. +/// \param view View to be used as superview. +/// +/// \param arrowPosition Point in view’s cordinates, where arrow will be pointing +/// +/// \param direction whenever arrow should be pointing up (message bubble is below the arrow) or down (message bubble is above the arrow). +/// +- (void)presentInView:(UIView * _Nonnull)view withArrowPosition:(CGPoint)arrowPosition direction:(enum FBSDKTooltipViewArrowDirection)direction; +/// Remove tooltip manually. +/// Calling this method isn’t necessary - tooltip will dismiss itself automatically after the <code>displayDuration</code>. +- (void)dismiss; +- (void)drawRect:(CGRect)rect; +- (void)layoutSubviews; +- (nonnull instancetype)initWithFrame:(CGRect)frame SWIFT_UNAVAILABLE; +@end + +/// FBSDKTooltipViewArrowDirection enum +/// Passed on construction to determine arrow orientation. +typedef SWIFT_ENUM_NAMED(NSUInteger, FBSDKTooltipViewArrowDirection, "ArrowDirection", closed) { + FBSDKTooltipViewArrowDirectionDown = 0, + FBSDKTooltipViewArrowDirectionUp = 1, +}; + +/// FBSDKTooltipColorStyle enum +/// Passed on construction to determine color styling. +typedef SWIFT_ENUM_NAMED(NSUInteger, FBSDKTooltipColorStyle, "ColorStyle", closed) { + FBSDKTooltipColorStyleFriendlyBlue = 0, + FBSDKTooltipColorStyleNeutralGray = 1, +}; + +@protocol FBSDKLoginTooltipViewDelegate; + +/// Represents a tooltip to be displayed next to a Facebook login button +/// to highlight features for new users. +/// The <code>FBSDKLoginButton</code> may display this view automatically. If you do +/// not use the <code>FBSDKLoginButton</code>, you can manually call one of the <code>present*</code> methods +/// as appropriate and customize behavior via <code>FBSDKLoginTooltipViewDelegate</code> delegate. +/// By default, the <code>FBSDKLoginTooltipView</code> is not added to the superview until it is +/// determined the app has migrated to the new login experience. You can override this +/// (e.g., to test the UI layout) by implementing the delegate or setting <code>forceDisplay</code> to YES. +SWIFT_CLASS_NAMED("FBLoginTooltipView") +@interface FBSDKLoginTooltipView : FBSDKTooltipView +/// the delegate +@property (nonatomic, weak) id <FBSDKLoginTooltipViewDelegate> _Nullable delegate; +/// if set to YES, the view will always be displayed and the delegate’s +/// <code>loginTooltipView:shouldAppear:</code> will NOT be called. +@property (nonatomic) BOOL forceDisplay; +/// if set to YES, the view will always be displayed and the delegate’s +/// <code>loginTooltipView:shouldAppear:</code> will NOT be called. +@property (nonatomic) BOOL shouldForceDisplay; +/// Create tooltip +- (nonnull instancetype)init; +- (nonnull instancetype)initWithTagline:(NSString * _Nullable)tagline message:(NSString * _Nullable)message colorStyle:(enum FBSDKTooltipColorStyle)colorStyle OBJC_DESIGNATED_INITIALIZER; +- (void)presentInView:(UIView * _Nonnull)view withArrowPosition:(CGPoint)arrowPosition direction:(enum FBSDKTooltipViewArrowDirection)direction; +@end + + +/// Internal Type exposed to facilitate transition to Swift. +/// API Subject to change or removal without warning. Do not use. +/// <ul> +/// <li> +/// Warning INTERNAL: DO NOT USE +/// </li> +/// </ul> +SWIFT_CLASS_NAMED("FBPermission") +@interface FBSDKPermission : NSObject +@property (nonatomic, readonly, copy) NSString * _Nonnull description; +@property (nonatomic, readonly) NSUInteger hash; +/// Attempts to initialize a new permission with the given string. +/// Creation will fail and return nil if the string is invalid. +/// \param string The raw permission string +/// +- (nullable instancetype)initWithString:(NSString * _Nonnull)string OBJC_DESIGNATED_INITIALIZER; +/// Returns a set of <code>FBPermission</code> from a set of raw permissions strings. +/// Will return nil if any of the input permissions is invalid. ++ (NSSet<FBSDKPermission *> * _Nullable)permissionsFromRawPermissions:(NSSet<NSString *> * _Nonnull)rawPermissions SWIFT_WARN_UNUSED_RESULT; +/// Returns a set of string permissions from a set of <code>FBPermission</code> by +/// extracting the “value” property for each element. ++ (NSSet<NSString *> * _Nonnull)rawPermissionsFromPermissions:(NSSet<FBSDKPermission *> * _Nonnull)permissions SWIFT_WARN_UNUSED_RESULT; +- (BOOL)isEqual:(id _Nullable)object SWIFT_WARN_UNUSED_RESULT; +- (nonnull instancetype)init SWIFT_UNAVAILABLE; ++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable"); +@end + +@class FBSDKLoginManagerLoginResult; + +/// A delegate for <code>FBSDKLoginButton</code> +SWIFT_PROTOCOL_NAMED("LoginButtonDelegate") +@protocol FBSDKLoginButtonDelegate <NSObject> +/// Sent to the delegate when the button was used to login. +/// @param loginButton The button being used to log in +/// @param result The results of the login +/// @param error The error (if any) from the login +- (void)loginButton:(FBSDKLoginButton * _Nonnull)loginButton didCompleteWithResult:(FBSDKLoginManagerLoginResult * _Nullable)result error:(NSError * _Nullable)error; +/// Sent to the delegate when the button was used to logout. +/// @param loginButton The button being used to log out. +- (void)loginButtonDidLogOut:(FBSDKLoginButton * _Nonnull)loginButton; +@optional +/// Sent to the delegate when the button is about to login. +/// @param loginButton The button being used to log in +/// @return <code>true</code> if the login should be allowed to proceed, <code>false</code> otherwise +- (BOOL)loginButtonWillLogin:(FBSDKLoginButton * _Nonnull)loginButton SWIFT_WARN_UNUSED_RESULT; +@end + + +/// A configuration to use for modifying the behavior of a login attempt. +SWIFT_CLASS_NAMED("LoginConfiguration") +@interface FBSDKLoginConfiguration : NSObject +/// The nonce that the configuration was created with. +/// A unique nonce will be used if none is provided to the initializer. +@property (nonatomic, readonly, copy) NSString * _Nonnull nonce; +/// The tracking preference. Defaults to <code>.enabled</code>. +@property (nonatomic, readonly) enum FBSDKLoginTracking tracking; +/// The requested permissions for the login attempt. Defaults to an empty set. +@property (nonatomic, readonly, copy) NSSet<FBSDKPermission *> * _Nonnull requestedPermissions; +/// The Messenger Page Id associated with this login request. +@property (nonatomic, readonly, copy) NSString * _Nullable messengerPageId; +/// The auth type associated with this login request. +@property (nonatomic, readonly) FBSDKLoginAuthType _Nullable authType; +/// The code verifier used in the PKCE process. +/// If not provided, a code verifier will be randomly generated. +@property (nonatomic, readonly, strong) FBSDKCodeVerifier * _Nonnull codeVerifier; +/// Attempts to initialize a new configuration with the expected parameters. +/// @param permissions the requested permissions for a login attempt. Permissions must be an array of strings that do not contain whitespace. +/// @param tracking the tracking preference to use for a login attempt. +/// @param nonce an optional nonce to use for the login attempt. A valid nonce must be a non-empty string without whitespace. +/// Creation of the configuration will fail if the nonce is invalid. +/// @param messengerPageId the associated page id to use for a login attempt. +- (nullable instancetype)initWithPermissions:(NSArray<NSString *> * _Nonnull)permissions tracking:(enum FBSDKLoginTracking)tracking nonce:(NSString * _Nonnull)nonce messengerPageId:(NSString * _Nullable)messengerPageId; +/// Attempts to initialize a new configuration with the expected parameters. +/// @param permissions the requested permissions for a login attempt. Permissions must be an array of strings that do not contain whitespace. +/// @param tracking the tracking preference to use for a login attempt. +/// @param nonce an optional nonce to use for the login attempt. A valid nonce must be a non-empty string without whitespace. +/// Creation of the configuration will fail if the nonce is invalid. +/// @param messengerPageId the associated page id to use for a login attempt. +/// @param authType auth_type param to use for login. +- (nullable instancetype)initWithPermissions:(NSArray<NSString *> * _Nonnull)permissions tracking:(enum FBSDKLoginTracking)tracking nonce:(NSString * _Nonnull)nonce messengerPageId:(NSString * _Nullable)messengerPageId authType:(FBSDKLoginAuthType _Nullable)authType; +/// Attempts to initialize a new configuration with the expected parameters. +/// @param permissions the requested permissions for a login attempt. Permissions must be an array of strings that do not contain whitespace. +/// @param tracking the tracking preference to use for a login attempt. +/// @param nonce an optional nonce to use for the login attempt. A valid nonce must be a non-empty string without whitespace. +/// Creation of the configuration will fail if the nonce is invalid. +- (nullable instancetype)initWithPermissions:(NSArray<NSString *> * _Nonnull)permissions tracking:(enum FBSDKLoginTracking)tracking nonce:(NSString * _Nonnull)nonce; +/// Attempts to initialize a new configuration with the expected parameters. +/// @param permissions the requested permissions for the login attempt. Permissions must be an array of strings that do not contain whitespace. +/// @param tracking the tracking preference to use for a login attempt. +/// @param messengerPageId the associated page id to use for a login attempt. +- (nullable instancetype)initWithPermissions:(NSArray<NSString *> * _Nonnull)permissions tracking:(enum FBSDKLoginTracking)tracking messengerPageId:(NSString * _Nullable)messengerPageId; +/// Attempts to initialize a new configuration with the expected parameters. +/// @param permissions the requested permissions for the login attempt. Permissions must be an array of strings that do not contain whitespace. +/// @param tracking the tracking preference to use for a login attempt. +/// @param messengerPageId the associated page id to use for a login attempt. +/// @param authType auth_type param to use for login. +- (nullable instancetype)initWithPermissions:(NSArray<NSString *> * _Nonnull)permissions tracking:(enum FBSDKLoginTracking)tracking messengerPageId:(NSString * _Nullable)messengerPageId authType:(FBSDKLoginAuthType _Nullable)authType; +/// Attempts to initialize a new configuration with the expected parameters. +/// @param permissions the requested permissions for a login attempt. Permissions must be an array of strings that do not contain whitespace. +/// @param tracking the tracking preference to use for a login attempt. +/// @param nonce an optional nonce to use for the login attempt. A valid nonce must be a non-empty string without whitespace. +/// Creation of the configuration will fail if the nonce is invalid. +/// @param messengerPageId the associated page id to use for a login attempt. +/// @param authType auth_type param to use for login. +/// @param codeVerifier The code verifier used in the PKCE process. +- (nullable instancetype)initWithPermissions:(NSArray<NSString *> * _Nonnull)permissions tracking:(enum FBSDKLoginTracking)tracking nonce:(NSString * _Nonnull)nonce messengerPageId:(NSString * _Nullable)messengerPageId authType:(FBSDKLoginAuthType _Nullable)authType codeVerifier:(FBSDKCodeVerifier * _Nonnull)codeVerifier OBJC_DESIGNATED_INITIALIZER; +/// Attempts to initialize a new configuration with the expected parameters. +/// @param permissions the requested permissions for the login attempt. Permissions must be an array of strings that do not contain whitespace. +/// @param tracking the tracking preference to use for a login attempt. +- (nullable instancetype)initWithPermissions:(NSArray<NSString *> * _Nonnull)permissions tracking:(enum FBSDKLoginTracking)tracking; +/// Attempts to initialize a new configuration with the expected parameters. +/// @param tracking the login tracking preference to use for a login attempt. +- (nullable instancetype)initWithTracking:(enum FBSDKLoginTracking)tracking; +- (nonnull instancetype)init SWIFT_UNAVAILABLE; ++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable"); +@end + +/// Custom error codes for login errors in the login error domain +typedef SWIFT_ENUM_NAMED(NSInteger, FBSDKLoginError, "LoginErrorCode", open) { +/// Reserved + FBSDKLoginErrorReserved = 300, +/// The error code for unknown errors + FBSDKLoginErrorUnknown = 301, +/// The user’s password has changed and must log in again + FBSDKLoginErrorPasswordChanged = 302, +/// The user must log in to their account on www.facebook.com to restore access + FBSDKLoginErrorUserCheckpointed = 303, +/// Indicates a failure to request new permissions because the user has changed + FBSDKLoginErrorUserMismatch = 304, +/// The user must confirm their account with Facebook before logging in + FBSDKLoginErrorUnconfirmedUser = 305, +/// The Accounts framework failed without returning an error, indicating the app’s slider in the +/// iOS Facebook Settings (device Settings -> Facebook -> App Name) has been disabled. + FBSDKLoginErrorSystemAccountAppDisabled = 306, +/// An error occurred related to Facebook system Account store + FBSDKLoginErrorSystemAccountUnavailable = 307, +/// The login response was missing a valid challenge string + FBSDKLoginErrorBadChallengeString = 308, +/// The ID token returned in login response was invalid + FBSDKLoginErrorInvalidIDToken = 309, +/// A current access token was required and not provided + FBSDKLoginErrorMissingAccessToken = 310, +}; + +@class UIViewController; + +/// Provides methods for logging the user in and out. +/// It works directly with <code>AccessToken</code> (for data access) and <code>AuthenticationToken</code> (for authentication); +/// it sets the “current” tokens upon successful authorizations (or sets to <code>nil</code> in case of <code>logOut</code>). +/// You should check <code>AccessToken.current</code> before calling a login method to see if there is +/// a cached token available (typically in a <code>viewDidLoad</code> implementation). +/// @warning If you are managing your own tokens outside of <code>AccessToken</code>, you will need to set +/// <code>AccessToken.current</code> before calling a login method to authorize further permissions on your tokens. +SWIFT_CLASS_NAMED("LoginManager") +@interface FBSDKLoginManager : NSObject +/// The default audience. You should set this if you intend to ask for publish permissions. +@property (nonatomic) enum FBSDKDefaultAudience defaultAudience; +/// Initialize an instance of <code>LoginManager.</code> +/// \param defaultAudience Optional default audience to use. Default: <code>.friends</code>. +/// +- (nonnull instancetype)initWithDefaultAudience:(enum FBSDKDefaultAudience)defaultAudience; +/// Logs the user in or authorizes additional permissions. +/// @param viewController the view controller from which to present the login UI. If nil, the topmost view +/// controller will be automatically determined and used. +/// @param configuration the login configuration to use. +/// @param completion the login completion handler. +/// Use this method when asking for permissions. You should only ask for permissions when they +/// are needed and the value should be explained to the user. You can inspect the +/// <code>FBSDKLoginManagerLoginResultBlock</code>’s <code>result.declinedPermissions</code> to provide more information +/// to the user if they decline permissions. +/// To reduce unnecessary login attempts, you should typically check if <code>AccessToken.current</code> +/// already contains the permissions you need. If it does, you probably do not need to call this method. +/// @warning You can only perform one login call at a time. Calling a login method before the completion handler is +/// called on a previous login attempt will result in an error. +/// @warning This method will present a UI to the user and thus should be called on the main thread. +- (void)logInFromViewController:(UIViewController * _Nullable)viewController configuration:(FBSDKLoginConfiguration * _Nullable)configuration completion:(FBSDKLoginManagerLoginResultBlock _Nonnull)completion; +/// Logs the user in or authorizes additional permissions. +/// @param permissions the optional array of permissions. Note this is converted to NSSet and is only +/// an NSArray for the convenience of literal syntax. +/// @param viewController the view controller to present from. If nil, the topmost view controller will be +/// automatically determined as best as possible. +/// @param handler the callback. +/// Use this method when asking for read permissions. You should only ask for permissions when they +/// are needed and explain the value to the user. You can inspect the <code>FBSDKLoginManagerLoginResultBlock</code>’s +/// <code>result.declinedPermissions</code> to provide more information to the user if they decline permissions. +/// You typically should check if <code>AccessToken.current</code> already contains the permissions you need before +/// asking to reduce unnecessary login attempts. For example, you could perform that check in <code>viewDidLoad</code>. +/// @warning You can only perform one login call at a time. Calling a login method before the completion handler is +/// called on a previous login attempt will result in an error. +/// @warning This method will present a UI to the user and thus should be called on the main thread. +- (void)logInWithPermissions:(NSArray<NSString *> * _Nonnull)permissions fromViewController:(UIViewController * _Nullable)viewController handler:(FBSDKLoginManagerLoginResultBlock _Nullable)handler; +/// Requests user’s permission to reathorize application’s data access, after it has expired due to inactivity. +/// @param viewController the view controller from which to present the login UI. If nil, the topmost view +/// controller will be automatically determined and used. +/// @param handler the callback. +/// Use this method when you need to reathorize your app’s access to user data via the Graph API. +/// You should only call this after access has expired. +/// You should provide as much context to the user as possible as to why you need to reauthorize the access, the +/// scope of access being reathorized, and what added value your app provides when the access is reathorized. +/// You can inspect the <code>result.declinedPermissions</code> to determine if you should provide more information to the +/// user based on any declined permissions. +/// @warning This method will reauthorize using a <code>LoginConfiguration</code> with <code>FBSDKLoginTracking</code> set to <code>.enabled</code>. +/// @warning This method will present UI the user. You typically should call this if <code>AccessToken.isDataAccessExpired</code> +/// is true. +- (void)reauthorizeDataAccess:(UIViewController * _Nonnull)viewController handler:(FBSDKLoginManagerLoginResultBlock _Nonnull)handler; +/// Logs the user out +/// This nils out the singleton instances of <code>AccessToken</code>, <code>AuthenticationToken</code> and <code>Profle</code>. +/// @note This is only a client side logout. It will not log the user out of their Facebook account. +- (void)logOut; +- (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER; +@end + + + +@class UIApplication; + +@interface FBSDKLoginManager (SWIFT_EXTENSION(FBSDKLoginKit)) <FBSDKURLOpening> ++ (FBSDKLoginManager * _Nonnull)makeOpener SWIFT_WARN_UNUSED_RESULT; +- (BOOL)application:(UIApplication * _Nullable)application openURL:(NSURL * _Nullable)url sourceApplication:(NSString * _Nullable)sourceApplication annotation:(id _Nullable)annotation SWIFT_WARN_UNUSED_RESULT; +- (BOOL)canOpenURL:(NSURL * _Nonnull)url forApplication:(UIApplication * _Nullable)application sourceApplication:(NSString * _Nullable)sourceApplication annotation:(id _Nullable)annotation SWIFT_WARN_UNUSED_RESULT; +- (void)applicationDidBecomeActive:(UIApplication * _Nonnull)application; +- (BOOL)isAuthenticationURL:(NSURL * _Nonnull)url SWIFT_WARN_UNUSED_RESULT; +- (BOOL)shouldStopPropagationOfURL:(NSURL * _Nonnull)url SWIFT_WARN_UNUSED_RESULT; +@end + +@class FBSDKAuthenticationToken; + +/// Describes the result of a login attempt. +SWIFT_CLASS_NAMED("LoginManagerLoginResult") +@interface FBSDKLoginManagerLoginResult : NSObject +/// The access token +@property (nonatomic, readonly, strong) FBSDKAccessToken * _Nullable token; +/// The authentication token +@property (nonatomic, readonly, strong) FBSDKAuthenticationToken * _Nullable authenticationToken; +/// Whether the login was cancelled by the user +@property (nonatomic, readonly) BOOL isCancelled; +/// The set of permissions granted by the user in the associated request. +/// Inspect the token’s permissions set for a complete list. +@property (nonatomic, readonly, copy) NSSet<NSString *> * _Nonnull grantedPermissions; +/// The set of permissions declined by the user in the associated request. +/// Inspect the token’s permissions set for a complete list. +@property (nonatomic, readonly, copy) NSSet<NSString *> * _Nonnull declinedPermissions; +/// Creates a new result +/// @param token The access token +/// @param authenticationToken The authentication token +/// @param isCancelled whether The login was cancelled by the user +/// @param grantedPermissions The set of granted permissions +/// @param declinedPermissions The set of declined permissions +- (nonnull instancetype)initWithToken:(FBSDKAccessToken * _Nullable)token authenticationToken:(FBSDKAuthenticationToken * _Nullable)authenticationToken isCancelled:(BOOL)isCancelled grantedPermissions:(NSSet<NSString *> * _Nonnull)grantedPermissions declinedPermissions:(NSSet<NSString *> * _Nonnull)declinedPermissions OBJC_DESIGNATED_INITIALIZER; +- (nonnull instancetype)init SWIFT_UNAVAILABLE; ++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable"); +@end + + +/// The <code>LoginTooltipViewDelegate</code> protocol defines the methods used to receive event +/// notifications from <code>FBLoginTooltipView</code> objects. +SWIFT_PROTOCOL_NAMED("LoginTooltipViewDelegate") +@protocol FBSDKLoginTooltipViewDelegate +@optional +/// Asks the delegate if the tooltip view should appear +/// @param view The tooltip view. +/// @param appIsEligible The value fetched from the server identifying if the app +/// is eligible for the new login experience. +/// Use this method to customize display behavior. +- (BOOL)loginTooltipView:(FBSDKLoginTooltipView * _Nonnull)view shouldAppear:(BOOL)appIsEligible SWIFT_WARN_UNUSED_RESULT; +/// Tells the delegate the tooltip view will appear, specifically after it’s been +/// added to the super view but before the fade in animation. +/// @param view The tooltip view. +- (void)loginTooltipViewWillAppear:(FBSDKLoginTooltipView * _Nonnull)view; +/// Tells the delegate the tooltip view will not appear (i.e., was not +/// added to the super view). +/// @param view The tooltip view. +- (void)loginTooltipViewWillNotAppear:(FBSDKLoginTooltipView * _Nonnull)view; +@end + +/// <code>enabled</code> and <code>limited</code> see: https://developers.facebook.com/docs/facebook-login/ios/limited-login/ +typedef SWIFT_ENUM_NAMED(NSUInteger, FBSDKLoginTracking, "LoginTracking", open) { + FBSDKLoginTrackingEnabled = 0, + FBSDKLoginTrackingLimited = 1, +}; + + +@class FBSDKProfile; + +/// Internal Type exposed to facilitate transition to Swift. +/// API Subject to change or removal without warning. Do not use. +/// <ul> +/// <li> +/// Warning INTERNAL: DO NOT USE +/// </li> +/// </ul> +/// Structured interface for accessing the parameters used to complete a log in request. +/// If <code>authenticationTokenString</code> is non-<code>nil</code>, the authentication succeeded. If <code>error</code> is +/// non-<code>nil</code> the request failed. If both are <code>nil</code>, the request was cancelled. +SWIFT_CLASS_NAMED("_LoginCompletionParameters") +@interface FBSDKLoginCompletionParameters : NSObject +@property (nonatomic, strong) FBSDKAuthenticationToken * _Nullable authenticationToken; +@property (nonatomic, strong) FBSDKProfile * _Nullable profile; +@property (nonatomic, copy) NSString * _Nullable accessTokenString; +@property (nonatomic, copy) NSString * _Nullable nonceString; +@property (nonatomic, copy) NSString * _Nullable authenticationTokenString; +@property (nonatomic, copy) NSString * _Nullable code; +@property (nonatomic, copy) NSSet<FBSDKPermission *> * _Nullable permissions; +@property (nonatomic, copy) NSSet<FBSDKPermission *> * _Nullable declinedPermissions; +@property (nonatomic, copy) NSSet<FBSDKPermission *> * _Nullable expiredPermissions; +@property (nonatomic, copy) NSString * _Nullable appID; +@property (nonatomic, copy) NSString * _Nullable userID; +@property (nonatomic) NSError * _Nullable error; +@property (nonatomic, copy) NSDate * _Nullable expirationDate; +@property (nonatomic, copy) NSDate * _Nullable dataAccessExpirationDate; +@property (nonatomic, copy) NSString * _Nullable challenge; +@property (nonatomic, copy) NSString * _Nullable graphDomain; +- (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER; +@end + +#endif +#if defined(__cplusplus) +#endif #if __has_attribute(external_source_symbol) # pragma clang attribute pop #endif @@ -217,7 +889,7 @@ #endif #elif defined(__x86_64__) && __x86_64__ -// Generated by Apple Swift version 5.4 (swiftlang-1205.0.26.9 clang-1205.0.19.55) +// Generated by Apple Swift version 5.7.2 (swiftlang-5.7.2.135.5 clang-1400.0.29.51) #ifndef FBSDKLOGINKIT_SWIFT_H #define FBSDKLOGINKIT_SWIFT_H #pragma clang diagnostic push @@ -240,11 +912,20 @@ # include <swift/objc-prologue.h> #endif +#pragma clang diagnostic ignored "-Wduplicate-method-match" #pragma clang diagnostic ignored "-Wauto-import" +#if defined(__OBJC__) #include <Foundation/Foundation.h> +#endif +#if defined(__cplusplus) +#include <cstdint> +#include <cstddef> +#include <cstdbool> +#else #include <stdint.h> #include <stddef.h> #include <stdbool.h> +#endif #if !defined(SWIFT_TYPEDEFS) # define SWIFT_TYPEDEFS 1 @@ -400,15 +1081,54 @@ #else # define SWIFT_DEPRECATED_OBJC(Msg) SWIFT_DEPRECATED_MSG(Msg) #endif +#if defined(__OBJC__) #if !defined(IBSegueAction) # define IBSegueAction #endif +#endif +#if !defined(SWIFT_EXTERN) +# if defined(__cplusplus) +# define SWIFT_EXTERN extern "C" +# else +# define SWIFT_EXTERN extern +# endif +#endif +#if !defined(SWIFT_CALL) +# define SWIFT_CALL __attribute__((swiftcall)) +#endif +#if defined(__cplusplus) +#if !defined(SWIFT_NOEXCEPT) +# define SWIFT_NOEXCEPT noexcept +#endif +#else +#if !defined(SWIFT_NOEXCEPT) +# define SWIFT_NOEXCEPT +#endif +#endif +#if defined(__cplusplus) +#if !defined(SWIFT_CXX_INT_DEFINED) +#define SWIFT_CXX_INT_DEFINED +namespace swift { +using Int = ptrdiff_t; +using UInt = size_t; +} +#endif +#endif +#if defined(__OBJC__) #if __has_feature(modules) #if __has_warning("-Watimport-in-framework-header") #pragma clang diagnostic ignored "-Watimport-in-framework-header" #endif +@import CoreFoundation; +@import FBSDKCoreKit; +@import Foundation; +@import ObjectiveC; +@import UIKit; #endif +#import <FBSDKLoginKit/FBSDKLoginKit.h> + +#endif #pragma clang diagnostic ignored "-Wproperty-attribute-mismatch" #pragma clang diagnostic ignored "-Wduplicate-method-arg" #if __has_warning("-Wpragma-clang-attribute") @@ -416,6 +1136,7 @@ #endif #pragma clang diagnostic ignored "-Wunknown-pragmas" #pragma clang diagnostic ignored "-Wnullability" +#pragma clang diagnostic ignored "-Wdollar-in-identifier-extension" #if __has_attribute(external_source_symbol) # pragma push_macro("any") @@ -424,13 +1145,638 @@ # pragma pop_macro("any") #endif +#if defined(__OBJC__) + +@class NSString; + +/// Represents a code verifier used in the PKCE (Proof Key for Code Exchange) +/// process. This is a cryptographically random string using the characters +/// A-Z, a-z, 0-9, and the punctuation characters -._~ (hyphen, period, +/// underscore, and tilde), between 43 and 128 characters long. +SWIFT_CLASS_NAMED("CodeVerifier") +@interface FBSDKCodeVerifier : NSObject +/// The string value of the code verifier +@property (nonatomic, readonly, copy) NSString * _Nonnull value; +/// The SHA256 hashed challenge of the code verifier +@property (nonatomic, readonly, copy) NSString * _Nonnull challenge; +/// Attempts to initialize a new code verifier instance with the given string. +/// Creation will fail and return nil if the string is invalid. +/// @param string the code verifier string +- (nullable instancetype)initWithString:(NSString * _Nonnull)string; +/// Initializes a new code verifier instance with a random string value +- (nonnull instancetype)init; +@end + +/// Passed to openURL to indicate which default audience to use for sessions that post data to Facebook. +/// Certain operations such as publishing a status or publishing a photo require an audience. When the user +/// grants an application permission to perform a publish operation, a default audience is selected as the +/// publication ceiling for the application. This enumerated value allows the application to select which +/// audience to ask the user to grant publish permission for. +typedef SWIFT_ENUM_NAMED(NSUInteger, FBSDKDefaultAudience, "DefaultAudience", open) { +/// Indicates that the user’s friends are able to see posts made by the application + FBSDKDefaultAudienceFriends = 0, +/// Indicates that only the user is able to see posts made by the application + FBSDKDefaultAudienceOnlyMe = 1, +/// Indicates that all Facebook users are able to see posts made by the application + FBSDKDefaultAudienceEveryone = 2, +}; + +@class NSURL; +@class NSDate; + +/// Describes the initial response when starting the device login flow. +/// This is used by <code>DeviceLoginManager</code>. +SWIFT_CLASS_NAMED("DeviceLoginCodeInfo") +@interface FBSDKDeviceLoginCodeInfo : NSObject +/// The unique id for this login flow. +@property (nonatomic, readonly, copy) NSString * _Nonnull identifier; +/// The short “user_code” that should be presented to the user. +@property (nonatomic, readonly, copy) NSString * _Nonnull loginCode; +/// The verification URL. +@property (nonatomic, readonly, copy) NSURL * _Nonnull verificationURL; +/// The expiration date. +@property (nonatomic, readonly, copy) NSDate * _Nonnull expirationDate; +/// The polling interval +@property (nonatomic, readonly) NSUInteger pollingInterval; +- (nonnull instancetype)initWithIdentifier:(NSString * _Nonnull)identifier loginCode:(NSString * _Nonnull)loginCode verificationURL:(NSURL * _Nonnull)verificationURL expirationDate:(NSDate * _Nonnull)expirationDate pollingInterval:(NSUInteger)pollingInterval OBJC_DESIGNATED_INITIALIZER; +- (nonnull instancetype)init SWIFT_UNAVAILABLE; ++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable"); +@end + +/// Custom error codes for device login errors in the login error domain +typedef SWIFT_ENUM_NAMED(NSInteger, FBSDKDeviceLoginError, "DeviceLoginErrorCode", open) { +/// Your device is polling too frequently. + FBSDKDeviceLoginErrorExcessivePolling = 1349172, +/// User has declined to authorize your application. + FBSDKDeviceLoginErrorAuthorizationDeclined = 1349173, +/// User has not yet authorized your application. Continue polling. + FBSDKDeviceLoginErrorAuthorizationPending = 1349174, +/// The code you entered has expired. + FBSDKDeviceLoginErrorCodeExpired = 1349152, +}; + +@protocol FBSDKDeviceLoginManagerDelegate; + +/// Use this class to perform a device login flow. +/// The device login flow starts by requesting a code from the device login API. +/// This class informs the delegate when this code is received. You should then present the +/// code to the user to enter. In the meantime, this class polls the device login API +/// periodically and informs the delegate of the results. +/// See <a href="https://developers.facebook.com/docs/facebook-login/for-devices">Facebook Device Login</a>. +SWIFT_CLASS_NAMED("DeviceLoginManager") +@interface FBSDKDeviceLoginManager : NSObject +/// The device login manager delegate. +@property (nonatomic, weak) id <FBSDKDeviceLoginManagerDelegate> _Nullable delegate; +/// The requested permissions. +@property (nonatomic, readonly, copy) NSArray<NSString *> * _Nonnull permissions; +/// The optional URL to redirect the user to after they complete the login. +/// The URL must be configured in your App Settings -> Advanced -> OAuth Redirect URIs +@property (nonatomic, copy) NSURL * _Nullable redirectURL; +/// Initializes a new instance. +/// @param permissions The permissions to request. +/// @param enableSmartLogin Whether to enable smart login. +- (nonnull instancetype)initWithPermissions:(NSArray<NSString *> * _Nonnull)permissions enableSmartLogin:(BOOL)enableSmartLogin OBJC_DESIGNATED_INITIALIZER; +/// Starts the device login flow +/// This instance will retain self until the flow is finished or cancelled. +- (void)start; +/// Attempts to cancel the device login flow. +- (void)cancel; +- (nonnull instancetype)init SWIFT_UNAVAILABLE; ++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable"); +@end + +@class NSNetService; +@class NSNumber; + +@interface FBSDKDeviceLoginManager (SWIFT_EXTENSION(FBSDKLoginKit)) <NSNetServiceDelegate> +- (void)netService:(NSNetService * _Nonnull)service didNotPublish:(NSDictionary<NSString *, NSNumber *> * _Nonnull)errorValues; +@end + + +@class FBSDKDeviceLoginManagerResult; + +/// A delegate for <code>DeviceLoginManager</code>. +SWIFT_PROTOCOL_NAMED("DeviceLoginManagerDelegate") +@protocol FBSDKDeviceLoginManagerDelegate +/// Indicates the device login flow has started. You should parse <code>codeInfo</code> to present the code to the user to enter. +/// @param loginManager the login manager instance. +/// @param codeInfo the code info data. +- (void)deviceLoginManager:(FBSDKDeviceLoginManager * _Nonnull)loginManager startedWithCodeInfo:(FBSDKDeviceLoginCodeInfo * _Nonnull)codeInfo; +/// Indicates the device login flow has finished. +/// @param loginManager the login manager instance. +/// @param result the results of the login flow. +/// @param error the error, if available. +/// The flow can be finished if the user completed the flow, cancelled, or if the code has expired. +- (void)deviceLoginManager:(FBSDKDeviceLoginManager * _Nonnull)loginManager completedWithResult:(FBSDKDeviceLoginManagerResult * _Nullable)result error:(NSError * _Nullable)error; +@end + +@class FBSDKAccessToken; + +/// Represents the results of the a device login flow. This is used by <code>DeviceLoginManager</code> +SWIFT_CLASS_NAMED("DeviceLoginManagerResult") +@interface FBSDKDeviceLoginManagerResult : NSObject +/// The token +@property (nonatomic, readonly, strong) FBSDKAccessToken * _Nullable accessToken; +/// Indicates if the login was cancelled by the user, or if the device login code has expired. +@property (nonatomic, readonly) BOOL isCancelled; +/// Internal method exposed to facilitate transition to Swift. +/// API Subject to change or removal without warning. Do not use. +/// @warning INTERNAL - DO NOT USE +- (nonnull instancetype)initWithToken:(FBSDKAccessToken * _Nullable)token isCancelled:(BOOL)cancelled OBJC_DESIGNATED_INITIALIZER; +- (nonnull instancetype)init SWIFT_UNAVAILABLE; ++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable"); +@end + +@protocol FBSDKLoginButtonDelegate; +enum FBSDKLoginButtonTooltipBehavior : NSUInteger; +enum FBSDKTooltipColorStyle : NSUInteger; +enum FBSDKLoginTracking : NSUInteger; +@class NSCoder; + +/// A button that initiates a log in or log out flow upon tapping. +/// <code>LoginButton</code> works with <code>AccessToken.current</code> to determine what to display, +/// and automatically starts authentication when tapped (i.e., you do not need to manually subscribe action targets). +/// Like <code>LoginManager</code>, you should make sure your app delegate is connected to <code>ApplicationDelegate</code> +/// in order for the button’s delegate to receive messages. +/// <code>LoginButton</code> has a fixed height of 30 pixels, but you may change the width. +/// Initializing the button with <code>nil</code> frame will size the button to its minimum frame. +SWIFT_CLASS_NAMED("FBLoginButton") +@interface FBSDKLoginButton : FBSDKButton +/// The default audience to use, if publish permissions are requested at login time. +@property (nonatomic) enum FBSDKDefaultAudience defaultAudience; +/// Gets or sets the delegate. +@property (nonatomic, weak) IBOutlet id <FBSDKLoginButtonDelegate> _Nullable delegate; +/// The permissions to request. +/// To provide the best experience, you should minimize the number of permissions you request, and only ask for them when needed. +/// For example, do not ask for “user_location” until you the information is actually used by the app. +/// Note this is converted to NSSet and is only +/// an NSArray for the convenience of literal syntax. +/// See <a href="https://developers.facebook.com/docs/facebook-login/permissions/">the permissions guide</a> for more details. +@property (nonatomic, copy) NSArray<NSString *> * _Nonnull permissions; +/// Gets or sets the desired tooltip behavior. +@property (nonatomic) enum FBSDKLoginButtonTooltipBehavior tooltipBehavior; +/// Gets or sets the desired tooltip color style. +@property (nonatomic) enum FBSDKTooltipColorStyle tooltipColorStyle; +/// Gets or sets the desired tracking preference to use for login attempts. Defaults to <code>.enabled</code> +@property (nonatomic) enum FBSDKLoginTracking loginTracking; +/// Gets or sets an optional nonce to use for login attempts. A valid nonce must be a non-empty string without whitespace. +/// An invalid nonce will not be set. Instead, default unique nonces will be used for login attempts. +@property (nonatomic, copy) NSString * _Nullable nonce; +/// Gets or sets an optional page id to use for login attempts. +@property (nonatomic, copy) NSString * _Nullable messengerPageId; +/// Gets or sets the login authorization type to use in the login request. Defaults to <code>rerequest</code>. Use <code>nil</code> to avoid +/// requesting permissions that were previously denied. +@property (nonatomic) FBSDKLoginAuthType _Nullable authType; +/// The code verifier used in the PKCE process. +/// If not provided, a code verifier will be randomly generated. +@property (nonatomic, strong) FBSDKCodeVerifier * _Nonnull codeVerifier; +- (nonnull instancetype)initWithFrame:(CGRect)frame OBJC_DESIGNATED_INITIALIZER; +- (nullable instancetype)initWithCoder:(NSCoder * _Nonnull)coder SWIFT_UNAVAILABLE; +- (void)didMoveToWindow; +- (CGRect)imageRectForContentRect:(CGRect)contentRect SWIFT_WARN_UNUSED_RESULT; +- (CGRect)titleRectForContentRect:(CGRect)contentRect SWIFT_WARN_UNUSED_RESULT; +- (void)layoutSubviews; +- (CGSize)sizeThatFits:(CGSize)size SWIFT_WARN_UNUSED_RESULT; +@end + +/// Indicates the desired login tooltip behavior. +typedef SWIFT_ENUM_NAMED(NSUInteger, FBSDKLoginButtonTooltipBehavior, "TooltipBehavior", open) { +/// The default behavior. The tooltip will only be displayed if +/// the app is eligible (determined by possible server round trip) + FBSDKLoginButtonTooltipBehaviorAutomatic = 0, +/// Force display of the tooltip (typically for UI testing) + FBSDKLoginButtonTooltipBehaviorForceDisplay = 1, +/// Force disable. In this case you can still exert more refined +/// control by manually constructing a <code>FBSDKLoginTooltipView</code> instance. + FBSDKLoginButtonTooltipBehaviorDisable = 2, +}; + +enum FBSDKTooltipViewArrowDirection : NSUInteger; + +/// Tooltip bubble with text in it used to display tips for UI elements, +/// with a pointed arrow (to refer to the UI element). +/// The tooltip fades in and will automatically fade out. See <code>displayDuration</code>. +SWIFT_CLASS_NAMED("FBTooltipView") +@interface FBSDKTooltipView : UIView +/// Gets or sets the amount of time in seconds the tooltip should be displayed. +/// Set this to zero to make the display permanent until explicitly dismissed. +/// Defaults to six seconds. +@property (nonatomic) NSTimeInterval displayDuration; +/// Gets or sets the color style after initialization. +/// Defaults to value passed to -initWithTagline:message:colorStyle:. +@property (nonatomic) enum FBSDKTooltipColorStyle colorStyle; +/// Gets or sets the message. +@property (nonatomic, copy) NSString * _Nullable message; +/// Gets or sets the optional phrase that comprises the first part of the label (and is highlighted differently). +@property (nonatomic, copy) NSString * _Nullable tagline; +/// Convenience constructor +- (nonnull instancetype)init SWIFT_UNAVAILABLE; ++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable"); +/// Designated initializer. +/// If you need to show a tooltip for login, consider using the <code>FBSDKLoginTooltipView</code> view. +/// See FBSDKLoginTooltipView +/// \param tagline First part of the label, that will be highlighted with different color. Can be nil. +/// +/// \param message Main message to display. +/// +/// \param colorStyle Color style to use for tooltip. +/// +- (nonnull instancetype)initWithTagline:(NSString * _Nullable)tagline message:(NSString * _Nullable)message colorStyle:(enum FBSDKTooltipColorStyle)colorStyle OBJC_DESIGNATED_INITIALIZER; +- (nullable instancetype)initWithCoder:(NSCoder * _Nonnull)coder OBJC_DESIGNATED_INITIALIZER SWIFT_UNAVAILABLE; +/// Show tooltip at the top or at the bottom of given view. +/// Tooltip will be added to anchorView.window.rootViewController.view +/// Use this method to present the tooltip with automatic positioning or +/// use -presentInView:withArrowPosition:direction: for manual positioning +/// If anchorView is nil or has no window - this method does nothing. +/// \param anchorView view to show at, must be already added to window view hierarchy, in order to decide +/// where tooltip will be shown. (If there’s not enough space at the top of the anchorView in window bounds - +/// tooltip will be shown at the bottom of it) +/// +- (void)presentFromView:(UIView * _Nonnull)anchorView; +/// Adds tooltip to given view, with given position and arrow direction. +/// \param view View to be used as superview. +/// +/// \param arrowPosition Point in view’s cordinates, where arrow will be pointing +/// +/// \param direction whenever arrow should be pointing up (message bubble is below the arrow) or down (message bubble is above the arrow). +/// +- (void)presentInView:(UIView * _Nonnull)view withArrowPosition:(CGPoint)arrowPosition direction:(enum FBSDKTooltipViewArrowDirection)direction; +/// Remove tooltip manually. +/// Calling this method isn’t necessary - tooltip will dismiss itself automatically after the <code>displayDuration</code>. +- (void)dismiss; +- (void)drawRect:(CGRect)rect; +- (void)layoutSubviews; +- (nonnull instancetype)initWithFrame:(CGRect)frame SWIFT_UNAVAILABLE; +@end + +/// FBSDKTooltipViewArrowDirection enum +/// Passed on construction to determine arrow orientation. +typedef SWIFT_ENUM_NAMED(NSUInteger, FBSDKTooltipViewArrowDirection, "ArrowDirection", closed) { + FBSDKTooltipViewArrowDirectionDown = 0, + FBSDKTooltipViewArrowDirectionUp = 1, +}; + +/// FBSDKTooltipColorStyle enum +/// Passed on construction to determine color styling. +typedef SWIFT_ENUM_NAMED(NSUInteger, FBSDKTooltipColorStyle, "ColorStyle", closed) { + FBSDKTooltipColorStyleFriendlyBlue = 0, + FBSDKTooltipColorStyleNeutralGray = 1, +}; + +@protocol FBSDKLoginTooltipViewDelegate; + +/// Represents a tooltip to be displayed next to a Facebook login button +/// to highlight features for new users. +/// The <code>FBSDKLoginButton</code> may display this view automatically. If you do +/// not use the <code>FBSDKLoginButton</code>, you can manually call one of the <code>present*</code> methods +/// as appropriate and customize behavior via <code>FBSDKLoginTooltipViewDelegate</code> delegate. +/// By default, the <code>FBSDKLoginTooltipView</code> is not added to the superview until it is +/// determined the app has migrated to the new login experience. You can override this +/// (e.g., to test the UI layout) by implementing the delegate or setting <code>forceDisplay</code> to YES. +SWIFT_CLASS_NAMED("FBLoginTooltipView") +@interface FBSDKLoginTooltipView : FBSDKTooltipView +/// the delegate +@property (nonatomic, weak) id <FBSDKLoginTooltipViewDelegate> _Nullable delegate; +/// if set to YES, the view will always be displayed and the delegate’s +/// <code>loginTooltipView:shouldAppear:</code> will NOT be called. +@property (nonatomic) BOOL forceDisplay; +/// if set to YES, the view will always be displayed and the delegate’s +/// <code>loginTooltipView:shouldAppear:</code> will NOT be called. +@property (nonatomic) BOOL shouldForceDisplay; +/// Create tooltip +- (nonnull instancetype)init; +- (nonnull instancetype)initWithTagline:(NSString * _Nullable)tagline message:(NSString * _Nullable)message colorStyle:(enum FBSDKTooltipColorStyle)colorStyle OBJC_DESIGNATED_INITIALIZER; +- (void)presentInView:(UIView * _Nonnull)view withArrowPosition:(CGPoint)arrowPosition direction:(enum FBSDKTooltipViewArrowDirection)direction; +@end + + +/// Internal Type exposed to facilitate transition to Swift. +/// API Subject to change or removal without warning. Do not use. +/// <ul> +/// <li> +/// Warning INTERNAL: DO NOT USE +/// </li> +/// </ul> +SWIFT_CLASS_NAMED("FBPermission") +@interface FBSDKPermission : NSObject +@property (nonatomic, readonly, copy) NSString * _Nonnull description; +@property (nonatomic, readonly) NSUInteger hash; +/// Attempts to initialize a new permission with the given string. +/// Creation will fail and return nil if the string is invalid. +/// \param string The raw permission string +/// +- (nullable instancetype)initWithString:(NSString * _Nonnull)string OBJC_DESIGNATED_INITIALIZER; +/// Returns a set of <code>FBPermission</code> from a set of raw permissions strings. +/// Will return nil if any of the input permissions is invalid. ++ (NSSet<FBSDKPermission *> * _Nullable)permissionsFromRawPermissions:(NSSet<NSString *> * _Nonnull)rawPermissions SWIFT_WARN_UNUSED_RESULT; +/// Returns a set of string permissions from a set of <code>FBPermission</code> by +/// extracting the “value” property for each element. ++ (NSSet<NSString *> * _Nonnull)rawPermissionsFromPermissions:(NSSet<FBSDKPermission *> * _Nonnull)permissions SWIFT_WARN_UNUSED_RESULT; +- (BOOL)isEqual:(id _Nullable)object SWIFT_WARN_UNUSED_RESULT; +- (nonnull instancetype)init SWIFT_UNAVAILABLE; ++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable"); +@end + +@class FBSDKLoginManagerLoginResult; + +/// A delegate for <code>FBSDKLoginButton</code> +SWIFT_PROTOCOL_NAMED("LoginButtonDelegate") +@protocol FBSDKLoginButtonDelegate <NSObject> +/// Sent to the delegate when the button was used to login. +/// @param loginButton The button being used to log in +/// @param result The results of the login +/// @param error The error (if any) from the login +- (void)loginButton:(FBSDKLoginButton * _Nonnull)loginButton didCompleteWithResult:(FBSDKLoginManagerLoginResult * _Nullable)result error:(NSError * _Nullable)error; +/// Sent to the delegate when the button was used to logout. +/// @param loginButton The button being used to log out. +- (void)loginButtonDidLogOut:(FBSDKLoginButton * _Nonnull)loginButton; +@optional +/// Sent to the delegate when the button is about to login. +/// @param loginButton The button being used to log in +/// @return <code>true</code> if the login should be allowed to proceed, <code>false</code> otherwise +- (BOOL)loginButtonWillLogin:(FBSDKLoginButton * _Nonnull)loginButton SWIFT_WARN_UNUSED_RESULT; +@end + + +/// A configuration to use for modifying the behavior of a login attempt. +SWIFT_CLASS_NAMED("LoginConfiguration") +@interface FBSDKLoginConfiguration : NSObject +/// The nonce that the configuration was created with. +/// A unique nonce will be used if none is provided to the initializer. +@property (nonatomic, readonly, copy) NSString * _Nonnull nonce; +/// The tracking preference. Defaults to <code>.enabled</code>. +@property (nonatomic, readonly) enum FBSDKLoginTracking tracking; +/// The requested permissions for the login attempt. Defaults to an empty set. +@property (nonatomic, readonly, copy) NSSet<FBSDKPermission *> * _Nonnull requestedPermissions; +/// The Messenger Page Id associated with this login request. +@property (nonatomic, readonly, copy) NSString * _Nullable messengerPageId; +/// The auth type associated with this login request. +@property (nonatomic, readonly) FBSDKLoginAuthType _Nullable authType; +/// The code verifier used in the PKCE process. +/// If not provided, a code verifier will be randomly generated. +@property (nonatomic, readonly, strong) FBSDKCodeVerifier * _Nonnull codeVerifier; +/// Attempts to initialize a new configuration with the expected parameters. +/// @param permissions the requested permissions for a login attempt. Permissions must be an array of strings that do not contain whitespace. +/// @param tracking the tracking preference to use for a login attempt. +/// @param nonce an optional nonce to use for the login attempt. A valid nonce must be a non-empty string without whitespace. +/// Creation of the configuration will fail if the nonce is invalid. +/// @param messengerPageId the associated page id to use for a login attempt. +- (nullable instancetype)initWithPermissions:(NSArray<NSString *> * _Nonnull)permissions tracking:(enum FBSDKLoginTracking)tracking nonce:(NSString * _Nonnull)nonce messengerPageId:(NSString * _Nullable)messengerPageId; +/// Attempts to initialize a new configuration with the expected parameters. +/// @param permissions the requested permissions for a login attempt. Permissions must be an array of strings that do not contain whitespace. +/// @param tracking the tracking preference to use for a login attempt. +/// @param nonce an optional nonce to use for the login attempt. A valid nonce must be a non-empty string without whitespace. +/// Creation of the configuration will fail if the nonce is invalid. +/// @param messengerPageId the associated page id to use for a login attempt. +/// @param authType auth_type param to use for login. +- (nullable instancetype)initWithPermissions:(NSArray<NSString *> * _Nonnull)permissions tracking:(enum FBSDKLoginTracking)tracking nonce:(NSString * _Nonnull)nonce messengerPageId:(NSString * _Nullable)messengerPageId authType:(FBSDKLoginAuthType _Nullable)authType; +/// Attempts to initialize a new configuration with the expected parameters. +/// @param permissions the requested permissions for a login attempt. Permissions must be an array of strings that do not contain whitespace. +/// @param tracking the tracking preference to use for a login attempt. +/// @param nonce an optional nonce to use for the login attempt. A valid nonce must be a non-empty string without whitespace. +/// Creation of the configuration will fail if the nonce is invalid. +- (nullable instancetype)initWithPermissions:(NSArray<NSString *> * _Nonnull)permissions tracking:(enum FBSDKLoginTracking)tracking nonce:(NSString * _Nonnull)nonce; +/// Attempts to initialize a new configuration with the expected parameters. +/// @param permissions the requested permissions for the login attempt. Permissions must be an array of strings that do not contain whitespace. +/// @param tracking the tracking preference to use for a login attempt. +/// @param messengerPageId the associated page id to use for a login attempt. +- (nullable instancetype)initWithPermissions:(NSArray<NSString *> * _Nonnull)permissions tracking:(enum FBSDKLoginTracking)tracking messengerPageId:(NSString * _Nullable)messengerPageId; +/// Attempts to initialize a new configuration with the expected parameters. +/// @param permissions the requested permissions for the login attempt. Permissions must be an array of strings that do not contain whitespace. +/// @param tracking the tracking preference to use for a login attempt. +/// @param messengerPageId the associated page id to use for a login attempt. +/// @param authType auth_type param to use for login. +- (nullable instancetype)initWithPermissions:(NSArray<NSString *> * _Nonnull)permissions tracking:(enum FBSDKLoginTracking)tracking messengerPageId:(NSString * _Nullable)messengerPageId authType:(FBSDKLoginAuthType _Nullable)authType; +/// Attempts to initialize a new configuration with the expected parameters. +/// @param permissions the requested permissions for a login attempt. Permissions must be an array of strings that do not contain whitespace. +/// @param tracking the tracking preference to use for a login attempt. +/// @param nonce an optional nonce to use for the login attempt. A valid nonce must be a non-empty string without whitespace. +/// Creation of the configuration will fail if the nonce is invalid. +/// @param messengerPageId the associated page id to use for a login attempt. +/// @param authType auth_type param to use for login. +/// @param codeVerifier The code verifier used in the PKCE process. +- (nullable instancetype)initWithPermissions:(NSArray<NSString *> * _Nonnull)permissions tracking:(enum FBSDKLoginTracking)tracking nonce:(NSString * _Nonnull)nonce messengerPageId:(NSString * _Nullable)messengerPageId authType:(FBSDKLoginAuthType _Nullable)authType codeVerifier:(FBSDKCodeVerifier * _Nonnull)codeVerifier OBJC_DESIGNATED_INITIALIZER; +/// Attempts to initialize a new configuration with the expected parameters. +/// @param permissions the requested permissions for the login attempt. Permissions must be an array of strings that do not contain whitespace. +/// @param tracking the tracking preference to use for a login attempt. +- (nullable instancetype)initWithPermissions:(NSArray<NSString *> * _Nonnull)permissions tracking:(enum FBSDKLoginTracking)tracking; +/// Attempts to initialize a new configuration with the expected parameters. +/// @param tracking the login tracking preference to use for a login attempt. +- (nullable instancetype)initWithTracking:(enum FBSDKLoginTracking)tracking; +- (nonnull instancetype)init SWIFT_UNAVAILABLE; ++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable"); +@end + +/// Custom error codes for login errors in the login error domain +typedef SWIFT_ENUM_NAMED(NSInteger, FBSDKLoginError, "LoginErrorCode", open) { +/// Reserved + FBSDKLoginErrorReserved = 300, +/// The error code for unknown errors + FBSDKLoginErrorUnknown = 301, +/// The user’s password has changed and must log in again + FBSDKLoginErrorPasswordChanged = 302, +/// The user must log in to their account on www.facebook.com to restore access + FBSDKLoginErrorUserCheckpointed = 303, +/// Indicates a failure to request new permissions because the user has changed + FBSDKLoginErrorUserMismatch = 304, +/// The user must confirm their account with Facebook before logging in + FBSDKLoginErrorUnconfirmedUser = 305, +/// The Accounts framework failed without returning an error, indicating the app’s slider in the +/// iOS Facebook Settings (device Settings -> Facebook -> App Name) has been disabled. + FBSDKLoginErrorSystemAccountAppDisabled = 306, +/// An error occurred related to Facebook system Account store + FBSDKLoginErrorSystemAccountUnavailable = 307, +/// The login response was missing a valid challenge string + FBSDKLoginErrorBadChallengeString = 308, +/// The ID token returned in login response was invalid + FBSDKLoginErrorInvalidIDToken = 309, +/// A current access token was required and not provided + FBSDKLoginErrorMissingAccessToken = 310, +}; + +@class UIViewController; + +/// Provides methods for logging the user in and out. +/// It works directly with <code>AccessToken</code> (for data access) and <code>AuthenticationToken</code> (for authentication); +/// it sets the “current” tokens upon successful authorizations (or sets to <code>nil</code> in case of <code>logOut</code>). +/// You should check <code>AccessToken.current</code> before calling a login method to see if there is +/// a cached token available (typically in a <code>viewDidLoad</code> implementation). +/// @warning If you are managing your own tokens outside of <code>AccessToken</code>, you will need to set +/// <code>AccessToken.current</code> before calling a login method to authorize further permissions on your tokens. +SWIFT_CLASS_NAMED("LoginManager") +@interface FBSDKLoginManager : NSObject +/// The default audience. You should set this if you intend to ask for publish permissions. +@property (nonatomic) enum FBSDKDefaultAudience defaultAudience; +/// Initialize an instance of <code>LoginManager.</code> +/// \param defaultAudience Optional default audience to use. Default: <code>.friends</code>. +/// +- (nonnull instancetype)initWithDefaultAudience:(enum FBSDKDefaultAudience)defaultAudience; +/// Logs the user in or authorizes additional permissions. +/// @param viewController the view controller from which to present the login UI. If nil, the topmost view +/// controller will be automatically determined and used. +/// @param configuration the login configuration to use. +/// @param completion the login completion handler. +/// Use this method when asking for permissions. You should only ask for permissions when they +/// are needed and the value should be explained to the user. You can inspect the +/// <code>FBSDKLoginManagerLoginResultBlock</code>’s <code>result.declinedPermissions</code> to provide more information +/// to the user if they decline permissions. +/// To reduce unnecessary login attempts, you should typically check if <code>AccessToken.current</code> +/// already contains the permissions you need. If it does, you probably do not need to call this method. +/// @warning You can only perform one login call at a time. Calling a login method before the completion handler is +/// called on a previous login attempt will result in an error. +/// @warning This method will present a UI to the user and thus should be called on the main thread. +- (void)logInFromViewController:(UIViewController * _Nullable)viewController configuration:(FBSDKLoginConfiguration * _Nullable)configuration completion:(FBSDKLoginManagerLoginResultBlock _Nonnull)completion; +/// Logs the user in or authorizes additional permissions. +/// @param permissions the optional array of permissions. Note this is converted to NSSet and is only +/// an NSArray for the convenience of literal syntax. +/// @param viewController the view controller to present from. If nil, the topmost view controller will be +/// automatically determined as best as possible. +/// @param handler the callback. +/// Use this method when asking for read permissions. You should only ask for permissions when they +/// are needed and explain the value to the user. You can inspect the <code>FBSDKLoginManagerLoginResultBlock</code>’s +/// <code>result.declinedPermissions</code> to provide more information to the user if they decline permissions. +/// You typically should check if <code>AccessToken.current</code> already contains the permissions you need before +/// asking to reduce unnecessary login attempts. For example, you could perform that check in <code>viewDidLoad</code>. +/// @warning You can only perform one login call at a time. Calling a login method before the completion handler is +/// called on a previous login attempt will result in an error. +/// @warning This method will present a UI to the user and thus should be called on the main thread. +- (void)logInWithPermissions:(NSArray<NSString *> * _Nonnull)permissions fromViewController:(UIViewController * _Nullable)viewController handler:(FBSDKLoginManagerLoginResultBlock _Nullable)handler; +/// Requests user’s permission to reathorize application’s data access, after it has expired due to inactivity. +/// @param viewController the view controller from which to present the login UI. If nil, the topmost view +/// controller will be automatically determined and used. +/// @param handler the callback. +/// Use this method when you need to reathorize your app’s access to user data via the Graph API. +/// You should only call this after access has expired. +/// You should provide as much context to the user as possible as to why you need to reauthorize the access, the +/// scope of access being reathorized, and what added value your app provides when the access is reathorized. +/// You can inspect the <code>result.declinedPermissions</code> to determine if you should provide more information to the +/// user based on any declined permissions. +/// @warning This method will reauthorize using a <code>LoginConfiguration</code> with <code>FBSDKLoginTracking</code> set to <code>.enabled</code>. +/// @warning This method will present UI the user. You typically should call this if <code>AccessToken.isDataAccessExpired</code> +/// is true. +- (void)reauthorizeDataAccess:(UIViewController * _Nonnull)viewController handler:(FBSDKLoginManagerLoginResultBlock _Nonnull)handler; +/// Logs the user out +/// This nils out the singleton instances of <code>AccessToken</code>, <code>AuthenticationToken</code> and <code>Profle</code>. +/// @note This is only a client side logout. It will not log the user out of their Facebook account. +- (void)logOut; +- (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER; +@end + + + +@class UIApplication; + +@interface FBSDKLoginManager (SWIFT_EXTENSION(FBSDKLoginKit)) <FBSDKURLOpening> ++ (FBSDKLoginManager * _Nonnull)makeOpener SWIFT_WARN_UNUSED_RESULT; +- (BOOL)application:(UIApplication * _Nullable)application openURL:(NSURL * _Nullable)url sourceApplication:(NSString * _Nullable)sourceApplication annotation:(id _Nullable)annotation SWIFT_WARN_UNUSED_RESULT; +- (BOOL)canOpenURL:(NSURL * _Nonnull)url forApplication:(UIApplication * _Nullable)application sourceApplication:(NSString * _Nullable)sourceApplication annotation:(id _Nullable)annotation SWIFT_WARN_UNUSED_RESULT; +- (void)applicationDidBecomeActive:(UIApplication * _Nonnull)application; +- (BOOL)isAuthenticationURL:(NSURL * _Nonnull)url SWIFT_WARN_UNUSED_RESULT; +- (BOOL)shouldStopPropagationOfURL:(NSURL * _Nonnull)url SWIFT_WARN_UNUSED_RESULT; +@end + +@class FBSDKAuthenticationToken; + +/// Describes the result of a login attempt. +SWIFT_CLASS_NAMED("LoginManagerLoginResult") +@interface FBSDKLoginManagerLoginResult : NSObject +/// The access token +@property (nonatomic, readonly, strong) FBSDKAccessToken * _Nullable token; +/// The authentication token +@property (nonatomic, readonly, strong) FBSDKAuthenticationToken * _Nullable authenticationToken; +/// Whether the login was cancelled by the user +@property (nonatomic, readonly) BOOL isCancelled; +/// The set of permissions granted by the user in the associated request. +/// Inspect the token’s permissions set for a complete list. +@property (nonatomic, readonly, copy) NSSet<NSString *> * _Nonnull grantedPermissions; +/// The set of permissions declined by the user in the associated request. +/// Inspect the token’s permissions set for a complete list. +@property (nonatomic, readonly, copy) NSSet<NSString *> * _Nonnull declinedPermissions; +/// Creates a new result +/// @param token The access token +/// @param authenticationToken The authentication token +/// @param isCancelled whether The login was cancelled by the user +/// @param grantedPermissions The set of granted permissions +/// @param declinedPermissions The set of declined permissions +- (nonnull instancetype)initWithToken:(FBSDKAccessToken * _Nullable)token authenticationToken:(FBSDKAuthenticationToken * _Nullable)authenticationToken isCancelled:(BOOL)isCancelled grantedPermissions:(NSSet<NSString *> * _Nonnull)grantedPermissions declinedPermissions:(NSSet<NSString *> * _Nonnull)declinedPermissions OBJC_DESIGNATED_INITIALIZER; +- (nonnull instancetype)init SWIFT_UNAVAILABLE; ++ (nonnull instancetype)new SWIFT_UNAVAILABLE_MSG("-init is unavailable"); +@end + + +/// The <code>LoginTooltipViewDelegate</code> protocol defines the methods used to receive event +/// notifications from <code>FBLoginTooltipView</code> objects. +SWIFT_PROTOCOL_NAMED("LoginTooltipViewDelegate") +@protocol FBSDKLoginTooltipViewDelegate +@optional +/// Asks the delegate if the tooltip view should appear +/// @param view The tooltip view. +/// @param appIsEligible The value fetched from the server identifying if the app +/// is eligible for the new login experience. +/// Use this method to customize display behavior. +- (BOOL)loginTooltipView:(FBSDKLoginTooltipView * _Nonnull)view shouldAppear:(BOOL)appIsEligible SWIFT_WARN_UNUSED_RESULT; +/// Tells the delegate the tooltip view will appear, specifically after it’s been +/// added to the super view but before the fade in animation. +/// @param view The tooltip view. +- (void)loginTooltipViewWillAppear:(FBSDKLoginTooltipView * _Nonnull)view; +/// Tells the delegate the tooltip view will not appear (i.e., was not +/// added to the super view). +/// @param view The tooltip view. +- (void)loginTooltipViewWillNotAppear:(FBSDKLoginTooltipView * _Nonnull)view; +@end + +/// <code>enabled</code> and <code>limited</code> see: https://developers.facebook.com/docs/facebook-login/ios/limited-login/ +typedef SWIFT_ENUM_NAMED(NSUInteger, FBSDKLoginTracking, "LoginTracking", open) { + FBSDKLoginTrackingEnabled = 0, + FBSDKLoginTrackingLimited = 1, +}; + + +@class FBSDKProfile; + +/// Internal Type exposed to facilitate transition to Swift. +/// API Subject to change or removal without warning. Do not use. +/// <ul> +/// <li> +/// Warning INTERNAL: DO NOT USE +/// </li> +/// </ul> +/// Structured interface for accessing the parameters used to complete a log in request. +/// If <code>authenticationTokenString</code> is non-<code>nil</code>, the authentication succeeded. If <code>error</code> is +/// non-<code>nil</code> the request failed. If both are <code>nil</code>, the request was cancelled. +SWIFT_CLASS_NAMED("_LoginCompletionParameters") +@interface FBSDKLoginCompletionParameters : NSObject +@property (nonatomic, strong) FBSDKAuthenticationToken * _Nullable authenticationToken; +@property (nonatomic, strong) FBSDKProfile * _Nullable profile; +@property (nonatomic, copy) NSString * _Nullable accessTokenString; +@property (nonatomic, copy) NSString * _Nullable nonceString; +@property (nonatomic, copy) NSString * _Nullable authenticationTokenString; +@property (nonatomic, copy) NSString * _Nullable code; +@property (nonatomic, copy) NSSet<FBSDKPermission *> * _Nullable permissions; +@property (nonatomic, copy) NSSet<FBSDKPermission *> * _Nullable declinedPermissions; +@property (nonatomic, copy) NSSet<FBSDKPermission *> * _Nullable expiredPermissions; +@property (nonatomic, copy) NSString * _Nullable appID; +@property (nonatomic, copy) NSString * _Nullable userID; +@property (nonatomic) NSError * _Nullable error; +@property (nonatomic, copy) NSDate * _Nullable expirationDate; +@property (nonatomic, copy) NSDate * _Nullable dataAccessExpirationDate; +@property (nonatomic, copy) NSString * _Nullable challenge; +@property (nonatomic, copy) NSString * _Nullable graphDomain; +- (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER; +@end + +#endif +#if defined(__cplusplus) +#endif #if __has_attribute(external_source_symbol) # pragma clang attribute pop #endif #pragma clang diagnostic pop #endif +#else +#error unsupported Swift architecture #endif -- Gitblit v1.8.0