motion-firebase 1.0.5

data/lib/vendor/FacebookSDK.framework/Versions/A/DeprecatedHeaders/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

data/lib/vendor/FacebookSDK.framework/Versions/A/DeprecatedHeaders/FBGraphLocation.h

@@ -0,0 +1,77 @@
+/*
+ * 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>
+#import "FBGraphObject.h"
+
+/*!
+ @protocol
+ 
+ @abstract
+ The `FBGraphLocation` protocol enables typed access to the `location` property
+ of a Facebook place object.
+
+ 
+ @discussion
+ The `FBGraphLocation` protocol represents the most commonly used properties of a 
+ location object. It may be used to access an `NSDictionary` object that has
+ been wrapped with an <FBGraphObject> facade.
+ */
+@protocol FBGraphLocation<FBGraphObject>
+
+/*!
+ @property
+ @abstract Typed access to a location's street.
+ */
+@property (retain, nonatomic) NSString *street;
+
+/*!
+ @property
+ @abstract Typed access to a location's city.
+ */
+@property (retain, nonatomic) NSString *city;
+
+/*!
+ @property
+ @abstract Typed access to a location's state.
+ */
+@property (retain, nonatomic) NSString *state;
+
+/*!
+ @property
+ @abstract Typed access to a location's country.
+ */
+@property (retain, nonatomic) NSString *country;
+
+/*!
+ @property
+ @abstract Typed access to a location's zip code.
+ */
+@property (retain, nonatomic) NSString *zip;
+
+/*!
+ @property
+ @abstract Typed access to a location's latitude.
+ */
+@property (retain, nonatomic) NSNumber *latitude; 
+
+/*!
+ @property
+ @abstract Typed access to a location's longitude.
+ */
+@property (retain, nonatomic) NSNumber *longitude;
+
+@end

data/lib/vendor/FacebookSDK.framework/Versions/A/DeprecatedHeaders/FBGraphObject.h

@@ -0,0 +1,224 @@
+/*
+ * 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>
+
+/*!
+ @protocol
+ 
+ @abstract
+ The `FBGraphObject` protocol is the base protocol which enables typed access to graph objects and
+ open graph objects. Inherit from this protocol or a sub-protocol in order to introduce custom types
+ for typed access to Facebook objects.
+ 
+ @discussion
+ The `FBGraphObject` protocol is the core type used by the Facebook SDK for iOS to 
+ represent objects in the Facebook Social Graph and the Facebook Open Graph (OG).
+ The `FBGraphObject` class implements useful default functionality, but is rarely
+ used directly by applications. The `FBGraphObject` protocol, in contrast is the
+ base protocol for all graph object access via the SDK. 
+ 
+ Goals of the FBGraphObject types:
+ <ul>
+   <li> Lightweight/maintainable/robust </li>
+   <li> Extensible and resilient to change, both by Facebook and third party (OG) </li>
+   <li> Simple and natural extension to Objective-C </li> 
+ </ul>
+
+ The FBGraphObject at its core is a duck typed (if it walks/swims/quacks... 
+ its a duck) model which supports an optional static facade. Duck-typing achieves
+ the flexibility necessary for Social Graph and OG uses, and the static facade
+ increases discoverability, maintainability, robustness and simplicity.
+ The following excerpt from the PlacePickerSample shows a simple use of the 
+ a facade protocol `FBGraphPlace` by an application: 
+
+ <pre>
+ &dash; (void)placePickerViewControllerSelectionDidChange:(FBPlacePickerViewController *)placePicker
+ {
+   id&#060;FBGraphPlace&#062; place = placePicker.selection;
+ 
+   // we'll use logging to show the simple typed property access to place and location info
+   NSLog(@"place=%@, city=%@, state=%@, lat long=%@ %@", 
+     place.name,
+     place.location.city,
+     place.location.state,
+     place.location.latitude,
+     place.location.longitude);
+ }
+ </pre>
+ 
+ Note that in this example, access to common place information is available through typed property
+ syntax. But if at some point places in the Social Graph supported additional fields "foo" and "bar", not
+ reflected in the `FBGraphPlace` protocol, the application could still access the values like so:
+
+ <pre>
+ NSString *foo = [place objectForKey:@"foo"]; // perhaps located at the ... in the preceding example
+ NSNumber *bar = [place objectForKey:@"bar"]; // extensibility applies to Social and Open graph uses
+ </pre>
+ 
+ In addition to untyped access, applications and future revisions of the SDK may add facade protocols by 
+ declaring a protocol inheriting the `FBGraphObject` protocol, like so:
+
+ <pre>
+ &#064;protocol MyGraphThing&#060;FBGraphObject&#062;
+ &#064;property (copy, nonatomic) NSString *id;
+ &#064;property (copy, nonatomic) NSString *name;
+ &#064;end
+ </pre>
+ 
+ Important: facade implementations are inferred by graph objects returned by the methods of the SDK. This 
+ means that no explicit implementation is required by application or SDK code. Any `FBGraphObject` instance 
+ may be cast to any `FBGraphObject` facade protocol, and accessed via properties. If a field is not present 
+ for a given facade property, the property will return nil.
+
+ The following layer diagram depicts some of the concepts discussed thus far:
+ 
+ <pre>
+                       *-------------* *------------* *-------------**--------------------------*
+            Facade --> | FBGraphUser | |FBGraphPlace| | MyGraphThing|| MyGraphPersonExtentension| ...
+                       *-------------* *------------* *-------------**--------------------------*
+                       *------------------------------------* *--------------------------------------*
+  Transparent impl --> |     FBGraphObject (instances)      | |      CustomClass&#060;FBGraphObject&#062;      |
+                       *------------------------------------* *--------------------------------------*
+                       *-------------------**------------------------* *-----------------------------*
+     Apparent impl --> |NSMutableDictionary||FBGraphObject (protocol)| |FBGraphObject (class methods)|
+                       *-------------------**------------------------* *-----------------------------*
+ </pre>
+ 
+ The *Facade* layer is meant for typed access to graph objects. The *Transparent impl* layer (more 
+ specifically, the instance capabilities of `FBGraphObject`) are used by the SDK and app logic
+ internally, but are not part of the public interface between application and SDK. The *Apparent impl*
+ layer represents the lower-level "duck-typed" use of graph objects.
+
+ Implementation note: the SDK returns `NSMutableDictionary` derived instances with types declared like
+ one of the following:
+ 
+ <pre>
+ NSMutableDictionary&#060;FBGraphObject&#062; *obj;     // no facade specified (still castable by app)
+ NSMutableDictionary&#060;FBGraphPlace&#062; *person;   // facade specified when possible
+ </pre>
+ 
+ However, when passing a graph object to the SDK, `NSMutableDictionary` is not assumed; only the
+ FBGraphObject protocol is assumed, like so:
+
+ <pre>
+ id&#060;FBGraphObject&#062; anyGraphObj;
+ </pre>
+ 
+ As such, the methods declared on the `FBGraphObject` protocol represent the methods used by the SDK to 
+ consume graph objects. While the `FBGraphObject` class implements the full `NSMutableDictionary` and KVC
+ interfaces, these are not consumed directly by the SDK, and are optional for custom implementations.
+ */
+@protocol FBGraphObject<NSObject>
+
+/*!
+ @method
+ @abstract
+ Returns the number of properties on this `FBGraphObject`.
+ */
+- (NSUInteger)count;
+/*!
+ @method
+ @abstract
+ Returns a property on this `FBGraphObject`.
+ 
+ @param aKey        name of the property to return
+ */
+- (id)objectForKey:(id)aKey;
+/*!
+ @method
+ @abstract
+ Returns an enumerator of the property naems on this `FBGraphObject`.
+ */
+- (NSEnumerator *)keyEnumerator;
+/*!
+ @method
+ @abstract
+ Removes a property on this `FBGraphObject`.
+
+ @param aKey        name of the property to remove
+ */
+- (void)removeObjectForKey:(id)aKey;
+/*!
+ @method
+ @abstract
+ Sets the value of a property on this `FBGraphObject`.
+
+ @param anObject    the new value of the property
+ @param aKey        name of the property to set
+ */
+- (void)setObject:(id)anObject forKey:(id)aKey;
+
+@end
+
+/*!
+ @class
+ 
+ @abstract
+ Static class with helpers for use with graph objects
+ 
+ @discussion
+ The public interface of this class is useful for creating objects that have the same graph characteristics
+ of those returned by methods of the SDK. This class also represents the internal implementation of the
+ `FBGraphObject` protocol, used by the Facebook SDK. Application code should not use the `FBGraphObject` class to 
+ access instances and instance members, favoring the protocol.
+ */
+@interface FBGraphObject : NSMutableDictionary<FBGraphObject>
+
+/*!
+ @method
+ @abstract
+ Used to create a graph object for, usually for use in posting a new graph object or action
+ */
++ (NSMutableDictionary<FBGraphObject>*)graphObject;
+
+/*!
+ @method
+ @abstract
+ Used to wrap an existing dictionary with a `FBGraphObject` facade
+
+ @discussion
+ Normally you will not need to call this method, as the Facebook SDK already "FBGraphObject-ifys" json objects
+ fetch via `FBRequest` and `FBRequestConnection`. However, you may have other reasons to create json objects in your 
+ application, which you would like to treat as a graph object. The pattern for doing this is that you pass the root
+ node of the json to this method, to retrieve a wrapper. From this point, if you traverse the graph, any other objects
+ deeper in the hierarchy will be wrapped as `FBGraphObject`'s in a lazy fashion.
+ 
+ This method is designed to avoid unnecessary memory allocations, and object copying. Due to this, the method does
+ not copy the source object if it can be avoided, but rather wraps and uses it as is. The returned object derives 
+ callers shoudl use the returned object after calls to this method, rather than continue to call methods on the original
+ object.
+ 
+ @param jsonDictionary              the dictionary representing the underlying object to wrap
+ */
++ (NSMutableDictionary<FBGraphObject>*)graphObjectWrappingDictionary:(NSDictionary*)jsonDictionary;
+
+/*!
+ @method
+ @abstract
+ Used to compare two `FBGraphObject`s to determine if represent the same object. We do not overload
+ the concept of equality as there are various types of equality that may be important for an `FBGraphObject`
+ (for instance, two different `FBGraphObject`s could represent the same object, but contain different
+ subsets of fields).
+ 
+ @param anObject          an `FBGraphObject` to test
+
+ @param anotherObject     the `FBGraphObject` to compare it against
+ */
++ (BOOL)isGraphObjectID:(id<FBGraphObject>)anObject sameAs:(id<FBGraphObject>)anotherObject;
+
+
+@end

data/lib/vendor/FacebookSDK.framework/Versions/A/DeprecatedHeaders/FBGraphPlace.h

@@ -0,0 +1,60 @@
+/*
+ * 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>
+#import "FBGraphLocation.h"
+#import "FBGraphObject.h"
+
+/*!
+ @protocol 
+ 
+ @abstract
+ The `FBGraphPlace` protocol enables typed access to a place object
+ as represented in the Graph API.
+
+ 
+ @discussion
+ The `FBGraphPlace` protocol represents the most commonly used properties of a 
+ Facebook place object. It may be used to access an `NSDictionary` object that has
+ been wrapped with an <FBGraphObject> facade.
+ */
+@protocol FBGraphPlace<FBGraphObject>
+
+/*!
+ @property
+ @abstract Typed access to the place ID.
+ */
+@property (retain, nonatomic) NSString *id;
+
+/*!
+ @property
+ @abstract Typed access to the place name.
+ */
+@property (retain, nonatomic) NSString *name;
+
+/*!
+ @property
+ @abstract Typed access to the place category.
+ */
+@property (retain, nonatomic) NSString *category;
+
+/*!
+ @property
+ @abstract Typed access to the place location.
+ */
+@property (retain, nonatomic) id<FBGraphLocation> location;
+
+@end