motion-firebase 1.0.5

data/lib/vendor/FacebookSDK.framework/Headers/FBError.h

@@ -0,0 +1,274 @@
+/*
+ * Copyright 2012 Facebook
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#import <Foundation/Foundation.h>
+
+/*!
+ The NSError domain of all errors returned by the Facebook SDK.
+*/
+extern NSString *const FacebookSDKDomain;
+
+/*!
+ The key in the userInfo NSDictionary of NSError where you can find
+ the inner NSError (if any).
+*/
+extern NSString *const FBErrorInnerErrorKey;
+
+/*!
+ The key in the userInfo NSDictionary of NSError for the parsed JSON response
+ from the server. In case of a batch, includes the JSON for a single FBRequest.
+*/
+extern NSString *const FBErrorParsedJSONResponseKey;
+
+/*!
+ The key in the userInfo NSDictionary of NSError indicating
+ the HTTP status code of the response (if any).
+*/
+extern NSString *const FBErrorHTTPStatusCodeKey;
+
+/*!
+ @abstract Error codes returned by the Facebook SDK in NSError.  
+ 
+ @discussion
+ These are valid only in the scope of FacebookSDKDomain.
+ */
+typedef enum FBErrorCode {
+    /*! 
+     Like nil for FBErrorCode values, represents an error code that
+     has not been initialized yet.
+     */
+    FBErrorInvalid = 0,
+
+    /// The operation failed because it was cancelled.
+    FBErrorOperationCancelled,
+    
+    /// A login attempt failed
+    FBErrorLoginFailedOrCancelled,
+
+    /// The graph API returned an error for this operation.
+    FBErrorRequestConnectionApi,
+
+    /*!
+     The operation failed because the server returned an unexpected
+     response.  You can get this error if you are not using the most
+     recent SDK, or if you set your application's migration settings
+     incorrectly for the version of the SDK you are using.
+    
+     If this occurs on the current SDK with proper app migration
+     settings, you may need to try changing to one request per batch.
+     */
+    FBErrorProtocolMismatch,
+
+    /// Non-success HTTP status code was returned from the operation.
+    FBErrorHTTPError,
+    
+    /// An endpoint that returns a binary response was used with FBRequestConnection;
+    /// endpoints that return image/jpg, etc. should be accessed using NSURLRequest
+    FBErrorNonTextMimeTypeReturned,
+
+    /// An error occurred while trying to display a native dialog
+    FBErrorNativeDialog,
+    
+    /// An error occurred using the FBInsights class
+    FBErrorInsights,
+    
+    /// An error occurred related to an iOS API call
+    FBErrorSystemAPI,
+  
+    /// An error occurred while trying to fetch publish install response data
+    FBErrorPublishInstallResponse,
+} FBErrorCode;
+
+/*!
+ @typedef FBErrorCategory enum
+ 
+ @abstract Indicates the Facebook SDK classification for the error
+ 
+ @discussion
+ */
+typedef enum {
+    /*! Indicates that the error category is invalid and likely represents an error that
+     is unrelated to Facebook or the Facebook SDK */
+    FBErrorCategoryInvalid                      = 0,
+    /*! Indicates that the error may be authentication related but the application should retry the operation.
+     This case may involve user action that must be taken, and so the application should also test
+     the fberrorShouldNotifyUser property and if YES display fberrorUserMessage to the user before retrying.*/
+    FBErrorCategoryRetry          = 1,
+    /*! Indicates that the error is authentication related and the application should reopen the session*/
+    FBErrorCategoryAuthenticationReopenSession  = 2,
+    /*! Indicates that the error is permission related */
+    FBErrorCategoryPermissions                  = 3,
+    /*! Indicates that the error implies that the server had an unexpected failure or may be temporarily down */
+    FBErrorCategoryServer                       = 4,
+    /*! Indicates that the error results from the server throttling the client */
+    FBErrorCategoryThrottling                   = 5,
+    /*! Indicates the user cancelled the operation */
+    FBErrorCategoryUserCancelled                = 6,
+    /*! Indicates that the error is Facebook-related but is uncategorizable, and likely newer than the 
+     current version of the SDK */
+    FBErrorCategoryFacebookOther                = -1,
+    /*! Indicates that the error is an application error resulting in a bad or malformed request to the server. */
+    FBErrorCategoryBadRequest                   = -2,
+} FBErrorCategory;
+
+/*!
+ The key in the userInfo NSDictionary of NSError where you can find
+ the inner NSError (if any).
+ */
+extern NSString *const FBErrorInnerErrorKey;
+
+/*!
+ The key in the userInfo NSDictionary of NSError where you can find 
+ the session associated with the error (if any).
+*/
+extern NSString *const FBErrorSessionKey;
+
+/*!
+ The key in the userInfo NSDictionary of NSError for unsuccessful 
+ logins (error.code equals FBErrorLoginFailedOrCancelled). If present,
+ the value will be one of the constants prefixed by FBErrorLoginFailedReason*.
+*/
+extern NSString *const FBErrorLoginFailedReason;
+
+/*!
+ The key in the userInfo NSDictionary of NSError for unsuccessful
+ logins (error.code equals FBErrorLoginFailedOrCancelled). If present,
+ the value indicates an original login error code wrapped by this error.
+ This is only used in the web dialog login flow.
+ */
+extern NSString *const FBErrorLoginFailedOriginalErrorCode;
+
+/*!
+ A value that may appear in an NSError userInfo dictionary under the
+ `FBErrorLoginFailedReason` key for login failures. Indicates the user
+ cancelled a web dialog auth.
+*/
+extern NSString *const FBErrorLoginFailedReasonInlineCancelledValue;
+
+/*!
+ A value that may appear in an NSError userInfo dictionary under the
+ `FBErrorLoginFailedReason` key for login failures. Indicates the user
+ did not cancel a web dialog auth.
+ */
+extern NSString *const FBErrorLoginFailedReasonInlineNotCancelledValue;
+
+/*!
+ A value that may appear in an NSError userInfo dictionary under the
+ `FBErrorLoginFailedReason` key for login failures. Indicates the user
+ cancelled a non-iOS 6 SSO (either Safari or Facebook App) login.
+ */
+extern NSString *const FBErrorLoginFailedReasonUserCancelledValue;
+
+/*!
+ A value that may appear in an NSError userInfo dictionary under the
+ `FBErrorLoginFailedReason` key for login failures. Indicates the user
+ cancelled an iOS system login.
+ */
+extern NSString *const FBErrorLoginFailedReasonUserCancelledSystemValue;
+
+/*!
+ A value that may appear in an NSError userInfo dictionary under the
+ `FBErrorLoginFailedReason` key for login failures. Indicates the app's
+ slider in iOS 6 (device Settings -> Privacy -> Facebook {app} ) has
+ been disabled.
+ */
+extern NSString *const FBErrorLoginFailedReasonSystemDisallowedWithoutErrorValue;
+
+/*!
+ A value that may appear in an NSError userInfo dictionary under the
+ `FBErrorLoginFailedReason` key for login failures. Indicates an error
+ has occurred when requesting Facebook account acccess in iOS 6 that was
+ not `FBErrorLoginFailedReasonSystemDisallowedWithoutErrorValue` nor
+ a user cancellation.
+ */
+extern NSString *const FBErrorLoginFailedReasonSystemError;
+extern NSString *const FBErrorLoginFailedReasonUnitTestResponseUnrecognized;
+
+/*!
+ A value that may appear in the NSError userInfo dictionary under the
+ `FBErrorLoginFailedReason` key when requesting new permissions fails. Indicates
+ the request for new permissions has failed because the session was closed.
+ */
+extern NSString *const FBErrorReauthorizeFailedReasonSessionClosed;
+
+/*!
+ A value that may appear in the NSError userInfo dictionary under the
+ `FBErrorLoginFailedReason` key when requesting new permissions fails. Indicates
+ the request for new permissions has failed because the user cancelled.
+ */
+extern NSString *const FBErrorReauthorizeFailedReasonUserCancelled;
+
+/*!
+ A value that may appear in the NSError userInfo dictionary under the
+ `FBErrorLoginFailedReason` key when requesting new permissions fails on
+ iOS 6 with the Facebook account. Indicates the request for new permissions has 
+ failed because the user cancelled.
+ */
+extern NSString *const FBErrorReauthorizeFailedReasonUserCancelledSystem;
+
+/*!
+ A value that may appear in the NSError userInfo dictionary under the
+ `FBErrorLoginFailedReason` key when requesting new permissions fails. Indicates
+ the request for new permissions has failed because the request was
+ for a different user than the original permission set.
+ */
+extern NSString *const FBErrorReauthorizeFailedReasonWrongUser;
+
+/*!
+ The key in the userInfo NSDictionary of NSError for errors
+ encountered with `FBNativeDialog` operations. (error.code equals FBErrorNativeDialog).
+ If present, the value will be one of the constants prefixed by FBErrorNativeDialog*.
+*/
+extern NSString *const FBErrorNativeDialogReasonKey;
+
+/*!
+ A value that may appear in the NSError userInfo dictionary under the
+`FBErrorNativeDialogReasonKey` key. Indicates that a native dialog is not supported 
+ in the current OS.
+*/
+extern NSString *const FBErrorNativeDialogNotSupported;
+
+/*!
+ A value that may appear in the NSError userInfo dictionary under the
+ `FBErrorNativeDialogReasonKey` key. Indicates that a native dialog cannot be
+ displayed because it is not appropriate for the current session. 
+*/
+extern NSString *const FBErrorNativeDialogInvalidForSession;
+
+/*!
+ A value that may appear in the NSError userInfo dictionary under the
+ `FBErrorNativeDialogReasonKey` key. Indicates that a native dialog cannot be
+ displayed for some other reason.
+ */
+extern NSString *const FBErrorNativeDialogCantBeDisplayed;
+
+/*!
+ The key in the userInfo NSDictionary of NSError for errors
+ encountered with `FBInsights` operations (error.code equals FBErrorInsights).
+*/
+extern NSString *const FBErrorInsightsReasonKey;
+
+// Exception strings raised by the Facebook SDK
+
+/*!
+ This exception is raised by methods in the Facebook SDK to indicate
+ that an attempted operation is invalid
+ */
+extern NSString *const FBInvalidOperationException;
+
+// Facebook SDK also raises exceptions the following common exceptions:
+//  NSInvalidArgumentException
+

data/lib/vendor/FacebookSDK.framework/Headers/FBFrictionlessRecipientCache.h

@@ -0,0 +1,86 @@
+/*
+ * Copyright 2013 Facebook
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#import <Foundation/Foundation.h>
+#import "FBWebDialogs.h"
+#import "FBRequest.h"
+#import "FBCacheDescriptor.h"
+
+/*!
+ @class FBFrictionlessRecipientCache
+ 
+ @abstract
+ Maintains a cache of friends that can recieve application requests from the user in
+ using the frictionless feature of the requests web dialog.
+ 
+ This class follows the `FBCacheDescriptor` pattern used elsewhere in the SDK, and applications may call
+ one of the prefetchAndCacheForSession methods to fetch a friend list prior to the
+ point where a dialog is presented. The cache is also updated with each presentation of the request 
+ dialog using the cache instance.
+ */
+@interface FBFrictionlessRecipientCache : FBCacheDescriptor<FBWebDialogsDelegate>
+
+/*!
+ @abstract
+ Initializes an empty cache instance
+ */
+- (id)init;
+
+/*! @abstract An array containing the list of known FBIDs for recipients enabled for frictionless requests */
+@property (nonatomic, readwrite, copy) NSArray *recipientIDs;
+
+/*!
+ @abstract
+ Checks to see if a given user or FBID for a user is known to be enabled for 
+ frictionless requestests
+ 
+ @param user An NSString, NSNumber of `FBGraphUser` representing a user to check
+ */
+- (BOOL)isFrictionlessRecipient:(id)user;
+
+/*!
+ @abstract
+ Checks to see if a collection of users or FBIDs for users are known to be enabled for
+ frictionless requestests
+ 
+ @param users An NSArray of NSString, NSNumber of `FBGraphUser` objects
+ representing users to check
+ */
+- (BOOL)areFrictionlessRecipients:(NSArray*)users;
+
+/*!
+ @abstract
+ Issues a request and fills the cache with a list of users to use for frictionless requests
+ 
+ @param session The session to use for the request; nil indicates that the Active Session should
+ be used
+ */
+- (void)prefetchAndCacheForSession:(FBSession *)session;
+
+/*!
+ @abstract
+ Issues a request and fills the cache with a list of users to use for frictionless requests
+ 
+ @param session The session to use for the request; nil indicates that the Active Session should
+ be used
+ 
+ @param handler An optional completion handler, called when the request for cached users has
+ completed. It can be useful to use the handler to enable UI or perform other request-related
+ operations, after the cache is populated.
+ */
+- (void)prefetchAndCacheForSession:(FBSession *)session
+                 completionHandler:(FBRequestHandler)handler;
+
+@end

data/lib/vendor/FacebookSDK.framework/Headers/FBFriendPickerViewController.h

@@ -0,0 +1,290 @@
+/*
+ * Copyright 2012 Facebook
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * 
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+#import <UIKit/UIKit.h>
+#import "FBGraphUser.h"
+#import "FBSession.h"
+#import "FBCacheDescriptor.h"
+#import "FBViewController.h"
+
+@protocol FBFriendPickerDelegate;
+@class FBFriendPickerCacheDescriptor;
+
+/*! 
+ @typedef FBFriendSortOrdering enum
+ 
+ @abstract Indicates the order in which friends should be listed in the friend picker.
+ 
+ @discussion
+ */
+typedef enum {
+    /*! Sort friends by first, middle, last names. */
+    FBFriendSortByFirstName,
+    /*! Sort friends by last, first, middle names. */
+    FBFriendSortByLastName
+} FBFriendSortOrdering;
+
+/*! 
+ @typedef FBFriendDisplayOrdering enum
+ 
+ @abstract Indicates whether friends should be displayed first-name-first or last-name-first.
+ 
+ @discussion
+ */
+typedef enum {
+    /*! Display friends as First Middle Last. */
+    FBFriendDisplayByFirstName,
+    /*! Display friends as Last First Middle. */
+    FBFriendDisplayByLastName,
+} FBFriendDisplayOrdering;
+
+
+/*! 
+ @class
+ 
+ @abstract 
+ The `FBFriendPickerViewController` class creates a controller object that manages 
+ the user interface for displaying and selecting Facebook friends.
+ 
+ @discussion
+ When the `FBFriendPickerViewController` view loads it creates a `UITableView` object 
+ where the friends will be displayed. You can access this view through the `tableView` 
+ property. The friend display can be sorted by first name or last name. Friends'
+ names can be displayed with the first name first or the last name first.
+ 
+ The friend data can be pre-fetched and cached prior to using the view controller. The
+ cache is setup using an <FBCacheDescriptor> object that can trigger the
+ data fetch. Any friend data requests will first check the cache and use that data.
+ If the friend picker is being displayed cached data will initially be shown before
+ a fresh copy is retrieved.
+ 
+ The `delegate` property may be set to an object that conforms to the <FBFriendPickerDelegate>
+ protocol. The `delegate` object will receive updates related to friend selection and
+ data changes. The delegate can also be used to filter the friends to display in the
+ picker.
+ */
+@interface FBFriendPickerViewController : FBViewController
+
+/*!
+ @abstract
+ Returns an outlet for the spinner used in the view controller.
+ */
+@property (nonatomic, retain) IBOutlet UIActivityIndicatorView *spinner;
+
+/*!
+ @abstract
+ Returns an outlet for the table view managed by the view controller.
+ */
+@property (nonatomic, retain) IBOutlet UITableView *tableView;
+
+/*!
+ @abstract
+ A Boolean value that specifies whether multi-select is enabled.
+ */
+@property (nonatomic) BOOL allowsMultipleSelection;
+
+/*!
+ @abstract
+ A Boolean value that indicates whether friend profile pictures are displayed.
+ */
+@property (nonatomic) BOOL itemPicturesEnabled;
+
+/*!
+ @abstract
+ Addtional fields to fetch when making the Graph API call to get friend data.
+ */
+@property (nonatomic, copy) NSSet *fieldsForRequest;
+
+/*!
+ @abstract
+ The session that is used in the request for friend data.
+ */
+@property (nonatomic, retain) FBSession *session;
+
+/*!
+ @abstract
+ The profile ID of the user whose friends are being viewed.
+ */
+@property (nonatomic, copy) NSString *userID;
+
+/*!
+ @abstract
+ The list of friends that are currently selected in the veiw.
+ The items in the array are <FBGraphUser> objects.
+ */
+@property (nonatomic, retain, readonly) NSArray *selection;
+
+/*!
+ @abstract
+ The order in which friends are sorted in the display.
+ */
+@property (nonatomic) FBFriendSortOrdering sortOrdering;
+
+/*!
+ @abstract
+ The order in which friends' names are displayed.
+ */
+@property (nonatomic) FBFriendDisplayOrdering displayOrdering;
+
+/*!
+ @abstract
+ Initializes a friend picker view controller.
+ */
+- (id)init;
+
+/*!
+ @abstract
+ Initializes a friend picker view controller.
+
+ @param aDecoder        An unarchiver object.
+ */
+- (id)initWithCoder:(NSCoder *)aDecoder;
+
+/*!
+ @abstract
+ Used to initialize the object
+ 
+ @param nibNameOrNil            The name of the nib file to associate with the view controller. The nib file name should not contain any leading path information. If you specify nil, the nibName property is set to nil.
+ @param nibBundleOrNil          The bundle in which to search for the nib file. This method looks for the nib file in the bundle's language-specific project directories first, followed by the Resources directory. If nil, this method looks for the nib file in the main bundle.
+ */
+- (id)initWithNibName:(NSString *)nibNameOrNil bundle:(NSBundle *)nibBundleOrNil;
+
+/*!
+ @abstract
+ Configures the properties used in the caching data queries.
+ 
+ @discussion
+ Cache descriptors are used to fetch and cache the data used by the view controller.
+ If the view controller finds a cached copy of the data, it will
+ first display the cached content then fetch a fresh copy from the server.
+ 
+ @param cacheDescriptor     The <FBCacheDescriptor> containing the cache query properties.
+ */
+- (void)configureUsingCachedDescriptor:(FBCacheDescriptor*)cacheDescriptor;
+
+/*!
+ @abstract
+ Initiates a query to get friend data. 
+ 
+ @discussion
+ A cached copy will be returned if available. The cached view is temporary until a fresh copy is
+ retrieved from the server. It is legal to call this more than once.
+ */
+- (void)loadData;
+
+/*!
+ @abstract
+ Updates the view locally without fetching data from the server or from cache.
+ 
+ @discussion
+ Use this if the filter or sort properties change. This may affect the order or
+ display of friend information but should not need require new data.
+ */
+- (void)updateView;
+
+/*!
+ @abstract
+ Clears the current selection, so the picker is ready for a fresh use.
+ */
+- (void)clearSelection;
+
+/*!
+ @method
+ 
+ @abstract
+ Creates a cache descriptor based on default settings of the `FBFriendPickerViewController` object.
+ 
+ @discussion
+ An `FBCacheDescriptor` object may be used to pre-fetch data before it is used by
+ the view controller. It may also be used to configure the `FBFriendPickerViewController` 
+ object.
+ */
++ (FBCacheDescriptor*)cacheDescriptor;
+
+/*!
+ @method
+ 
+ @abstract
+ Creates a cache descriptor with additional fields and a profile ID for use with the `FBFriendPickerViewController` object.
+ 
+ @discussion
+ An `FBCacheDescriptor` object may be used to pre-fetch data before it is used by
+ the view controller. It may also be used to configure the `FBFriendPickerViewController` 
+ object.
+ 
+ @param userID              The profile ID of the user whose friends will be displayed. A nil value implies a "me" alias. 
+ @param fieldsForRequest    The set of additional fields to include in the request for friend data. 
+ */
++ (FBCacheDescriptor*)cacheDescriptorWithUserID:(NSString*)userID fieldsForRequest:(NSSet*)fieldsForRequest;
+
+@end
+
+/*! 
+ @protocol
+ 
+ @abstract 
+ The `FBFriendPickerDelegate` protocol defines the methods used to receive event 
+ notifications and allow for deeper control of the <FBFriendPickerViewController>
+ view.
+ */
+@protocol FBFriendPickerDelegate <FBViewControllerDelegate>
+@optional
+
+/*!
+ @abstract 
+ Tells the delegate that data has been loaded.
+
+ @discussion
+ The <FBFriendPickerViewController> object's `tableView` property is automatically 
+ reloaded when this happens. However, if another table view, for example the
+ `UISearchBar` is showing data, then it may also need to be reloaded.
+
+ @param friendPicker        The friend picker view controller whose data changed.
+ */
+- (void)friendPickerViewControllerDataDidChange:(FBFriendPickerViewController *)friendPicker;
+
+/*!
+ @abstract
+ Tells the delegate that the selection has changed.
+
+ @param friendPicker        The friend picker view controller whose selection changed.
+ */
+- (void)friendPickerViewControllerSelectionDidChange:(FBFriendPickerViewController *)friendPicker;
+
+/*!
+ @abstract
+ Asks the delegate whether to include a friend in the list.
+ 
+ @discussion
+ This can be used to implement a search bar that filters the friend list.
+
+ @param friendPicker        The friend picker view controller that is requesting this information.
+ @param user                An <FBGraphUser> object representing the friend.
+ */
+- (BOOL)friendPickerViewController:(FBFriendPickerViewController *)friendPicker
+                 shouldIncludeUser:(id <FBGraphUser>)user;
+
+/*!
+ @abstract
+ Tells the delegate that there is a communication error.
+
+ @param friendPicker        The friend picker view controller that encountered the error.
+ @param error               An error object containing details of the error.
+ */
+- (void)friendPickerViewController:(FBFriendPickerViewController *)friendPicker
+                       handleError:(NSError *)error;
+
+@end