motion-firebase 1.0.5

data/lib/vendor/FacebookSDK.framework/Versions/Current/Headers/FBWebDialogs.h

@@ -0,0 +1,234 @@
+/*
+ * 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 <UIKit/UIKit.h>
+
+@class FBFrictionlessRecipientCache;
+@class FBSession;
+@protocol FBWebDialogsDelegate;
+
+/*!
+ @typedef FBWebDialogResult enum
+ 
+ @abstract
+ Passed to a handler to indicate the result of a dialog being displayed to the user.
+*/
+typedef enum {
+    /*! Indicates that the dialog action completed successfully. Note, that cancel operations represent completed dialog operations. 
+     The url argument may be used to distinguish between success and user-cancelled cases */
+    FBWebDialogResultDialogCompleted,
+    /*! Indicates that the dialog operation was not completed. This occurs in cases such as the closure of the web-view using the X in the upper left corner. */
+    FBWebDialogResultDialogNotCompleted
+} FBWebDialogResult;
+
+/*!
+ @typedef
+ 
+ @abstract Defines a handler that will be called in response to the web dialog
+ being dismissed
+ */
+typedef void (^FBWebDialogHandler)(
+    FBWebDialogResult result,
+    NSURL *resultURL,
+    NSError *error);
+
+/*!
+ @class FBWebDialogs
+ 
+ @abstract
+ Provides methods to display web based dialogs to the user.
+*/ 
+@interface FBWebDialogs : NSObject
+
+/*!
+ @abstract
+ Presents a Facebook web dialog (https://developers.facebook.com/docs/reference/dialogs/) 
+ such as feed or apprequest.
+ 
+ @param session Represents the session to use for the dialog. May be nil, which uses
+ the active session if present, or returns NO, if not.
+ 
+ @param dialog Represents the dialog or method name, such as @"feed"
+ 
+ @param parameters A dictionary of parameters to be passed to the dialog
+ 
+ @param handler An optional handler that will be called when the dialog is dismissed. Note,
+ that if the method returns NO, the handler is not called. May be nil.
+ */
++ (void)presentDialogModallyWithSession:(FBSession *)session
+                                 dialog:(NSString *)dialog
+                             parameters:(NSDictionary *)parameters
+                                handler:(FBWebDialogHandler)handler;
+
+/*!
+ @abstract
+ Presents a Facebook web dialog (https://developers.facebook.com/docs/reference/dialogs/)
+ such as feed or apprequest.
+ 
+ @param session Represents the session to use for the dialog. May be nil, which uses
+ the active session if present, or returns NO, if not.
+ 
+ @param dialog Represents the dialog or method name, such as @"feed"
+ 
+ @param parameters A dictionary of parameters to be passed to the dialog
+ 
+ @param handler An optional handler that will be called when the dialog is dismissed. Note,
+ that if the method returns NO, the handler is not called. May be nil.
+ 
+ @param delegate An optional delegate to allow for advanced processing of web based 
+ dialogs. See 'FBWebDialogsDelegate' for more details.
+ */
++ (void)presentDialogModallyWithSession:(FBSession *)session
+                                 dialog:(NSString *)dialog
+                             parameters:(NSDictionary *)parameters
+                                handler:(FBWebDialogHandler)handler
+                               delegate:(id<FBWebDialogsDelegate>)delegate;
+
+/*!
+ @abstract
+ Presents a Facebook apprequest dialog.
+ 
+ @param session Represents the session to use for the dialog. May be nil, which uses
+ the active session if present.
+ 
+ @param message The required message for the dialog.
+ 
+ @param title An optional title for the dialog.
+ 
+ @param parameters A dictionary of additional parameters to be passed to the dialog. May be nil
+ 
+ @param handler An optional handler that will be called when the dialog is dismissed. May be nil.
+ */
++ (void)presentRequestsDialogModallyWithSession:(FBSession *)session
+                                        message:(NSString *)message
+                                          title:(NSString *)title
+                                     parameters:(NSDictionary *)parameters
+                                        handler:(FBWebDialogHandler)handler;
+
+/*!
+ @abstract
+ Presents a Facebook apprequest dialog.
+ 
+ @param session Represents the session to use for the dialog. May be nil, which uses
+ the active session if present.
+ 
+ @param message The required message for the dialog.
+ 
+ @param title An optional title for the dialog.
+ 
+ @param parameters A dictionary of additional parameters to be passed to the dialog. May be nil
+ 
+ @param handler An optional handler that will be called when the dialog is dismissed. May be nil.
+ 
+ @param friend cache An optional cache object used to enable frictionless sharing for a known set of friends. The
+ cache instance should be preserved for the life of the session and reused for multiple calls to the present method.
+ As the users set of friends enabled for frictionless sharing changes, this method auto-updates the cache.
+ */
++ (void)presentRequestsDialogModallyWithSession:(FBSession *)session
+                                        message:(NSString *)message
+                                          title:(NSString *)title
+                                     parameters:(NSDictionary *)parameters
+                                        handler:(FBWebDialogHandler)handler
+                                    friendCache:(FBFrictionlessRecipientCache *)friendCache;
+
+/*!
+ @abstract
+ Presents a Facebook feed dialog.
+ 
+ @param session Represents the session to use for the dialog. May be nil, which uses
+ the active session if present.
+ 
+ @param parameters A dictionary of additional parameters to be passed to the dialog. May be nil
+ 
+ @param handler An optional handler that will be called when the dialog is dismissed. May be nil.
+ */
++ (void)presentFeedDialogModallyWithSession:(FBSession *)session
+                                 parameters:(NSDictionary *)parameters
+                                    handler:(FBWebDialogHandler)handler;
+
+@end
+
+/*!
+ @protocol
+ 
+ @abstract
+ The `FBWebDialogsDelegate` protocol enables the plugging of advanced behaviors into 
+ the presentation flow of a Facebook web dialog. Advanced uses include modification
+ of parameters and application-level handling of links on the dialog. The
+ `FBFrictionlessRequestFriendCache` class implements this protocol to add frictionless
+ behaviors to a presentation of the request dialog.
+ */
+@protocol FBWebDialogsDelegate<NSObject>
+
+@optional
+
+/*!
+ @abstract
+ Called prior to the presentation of a web dialog
+ 
+ @param dialog A string representing the method or dialog name of the dialog being presented.
+ 
+ @param parameters A mutable dictionary of parameters which will be sent to the dialog.
+ 
+ @param session The session object to use with the dialog.
+ */
+- (void)webDialogsWillPresentDialog:(NSString *)dialog
+                         parameters:(NSMutableDictionary *)parameters
+                            session:(FBSession *)session;
+
+/*!
+ @abstract
+ Called when the user of a dialog clicks a link that would cause a transition away from the application.
+ Your application may handle this method, and return NO if the URL handling will be performed by the application.
+ 
+ @param dialog A string representing the method or dialog name of the dialog being presented.
+ 
+ @param parameters A dictionary of parameters which were sent to the dialog.
+ 
+ @param session The session object to use with the dialog.
+ 
+ @param url The url in question, which will not be handled by the SDK if this method NO
+ */
+- (BOOL)webDialogsDialog:(NSString *)dialog
+              parameters:(NSDictionary *)parameters
+                 session:(FBSession *)session
+     shouldAutoHandleURL:(NSURL *)url;
+
+/*!
+ @abstract
+ Called when the dialog is about to be dismissed
+ 
+ @param dialog A string representing the method or dialog name of the dialog being presented.
+ 
+ @param parameters A dictionary of parameters which were sent to the dialog.
+ 
+ @param session The session object to use with the dialog.
+ 
+ @param result A pointer to a result, which may be read or changed by the handling method as needed
+ 
+ @param url A pointer to a pointer to a URL representing the URL returned by the dialog, which may be read or changed by this mehthod
+ 
+ @param error A pointer to a pointer to an error object which may be read or changed by this method as needed
+ */
+- (void)webDialogsWillDismissDialog:(NSString *)dialog
+                         parameters:(NSDictionary *)parameters
+                            session:(FBSession *)session
+                             result:(FBWebDialogResult *)result
+                                url:(NSURL **)url
+                              error:(NSError **)error;
+
+@end
+

data/lib/vendor/FacebookSDK.framework/Versions/Current/Headers/FacebookSDK.h

@@ -0,0 +1,132 @@
+/*
+ * Copyright 2012
+ *
+ * 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.
+ */
+
+// core
+#import "FBSession.h"
+#import "FBAccessTokenData.h"
+#import "FBRequest.h"
+#import "FBError.h"
+#import "NSError+FBError.h"
+#import "FBSettings.h"
+#import "FBInsights.h"
+
+// graph
+#import "FBGraphUser.h"
+#import "FBGraphPlace.h"
+#import "FBGraphLocation.h"
+#import "FBGraphObject.h"           // + design summary for graph component-group
+#import "FBOpenGraphAction.h"
+
+// ux
+#import "FBLoginView.h"
+#import "FBProfilePictureView.h"
+#import "FBUserSettingsViewController.h"
+#import "FBPlacePickerViewController.h"
+#import "FBFriendPickerViewController.h"
+#import "FBCacheDescriptor.h"
+#import "FBNativeDialogs.h"
+#import "FBWebDialogs.h"
+#import "FBFrictionlessRecipientCache.h"
+
+/*!
+ @header
+ 
+ @abstract  Library header, import this to import all of the public types
+            in the Facebook SDK
+ 
+ @discussion
+
+////////////////////////////////////////////////////////////////////////////////
+
+
+ Summary: this header summarizes the structure and goals of the Facebook SDK for iOS.
+ Goals:
+ * Leverage and work well with modern features of iOS (e.g. blocks, ARC, etc.)
+ * Patterned after best of breed iOS frameworks (e.g. naming, pattern-use, etc.)
+ * Common integration experience is simple & easy to describe
+ * Factored to enable a growing list of scenarios over time
+ 
+ Notes on approaches:
+ 1. We use a key scenario to drive prioritization of work for a given update
+ 2. We are building-atop and refactoring, rather than replacing, existing iOS SDK releases
+ 3. We use take an incremental approach where we can choose to maintain as little or as much compatibility with the existing SDK needed
+    a) and so we will be developing to this approach
+    b) and then at push-time for a release we will decide when/what to break
+         on a feature by feature basis
+ 4. Some light but critical infrastructure is needed to support both the goals
+    and the execution of this change (e.g. a build/package/deploy process)
+ 
+ Design points:
+ We will move to a more object-oriented approach, in order to facilitate the
+ addition of a different class of objects, such as controls and visual helpers
+ (e.g. FBLikeView, FBPersonView), as well as sub-frameworks to enable scenarios 
+ such (e.g. FBOpenGraphEntity, FBLocalEntityCache, etc.)
+ 
+ As we add features, it will no longer be appropriate to host all functionality
+ in the Facebook class, though it will be maintained for some time for migration
+ purposes. Instead functionality lives in related collections of classes.
+
+ <pre>
+ @textblock
+ 
+               *------------* *----------*  *----------------* *---*
+  Scenario --> |FBPersonView| |FBLikeView|  | FBPlacePicker  | | F |
+               *------------* *----------*  *----------------* | a |
+               *-------------------*  *----------*  *--------* | c |
+ Component --> |   FBGraphObject   |  | FBDialog |  | FBView | | e |
+               *-------------------*  *----------*  *--------* | b |
+               *---------* *---------* *---------------------* | o |
+      Core --> |FBSession| |FBRequest| |Utilities (e.g. JSON)| | o |
+               *---------* *---------* *---------------------* * k *
+
+ @/textblock
+ </pre>
+
+ The figure above describes three layers of functionality, with the existing
+ Facebook on the side as a helper proxy to a subset of the overall SDK. The
+ layers loosely organize the SDK into *Core Objects* necessary to interface 
+ with Facebook, higher-level *Framework Components* that feel like natural
+ extensions to existing frameworks such as UIKit and Foundation, but which
+ surface behavior broadly applicable to Facebook, and finally the
+ *Scenario Objects*, which provide deeper turn-key capibilities for useful 
+ mobile scenarios.
+ 
+ Use example (low barrier use case):
+
+ <pre>
+ @textblock
+
+// log on to Facebook
+[FBSession sessionOpenWithPermissions:nil
+                    completionHandler:^(FBSession *session, 
+                                        FBSessionState status, 
+                                        NSError *error) {
+                        if (session.isOpen) {
+                            // request basic information for the user
+                            [FBRequestConnection startWithGraphPath:@"me"
+                                                  completionHandler:^void(FBRequestConnection *request, 
+                                                                          id result,
+                                                                          NSError *error) {
+                                                      if (!error) {
+                                                          // get json from result
+                                                      }
+                                                  }];
+                        }
+                    }];
+ @/textblock
+ </pre>
+ 
+ */

data/lib/vendor/FacebookSDK.framework/Versions/Current/Headers/NSError+FBError.h

@@ -0,0 +1,59 @@
+/*
+ * 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 "FBError.h"
+
+/*!
+ @category NSError(FBError)
+ 
+ @abstract
+ Adds additional properties to NSError to provide more information for Facebook related errors. 
+ */
+@interface NSError (FBError)
+
+/*!
+ @abstract
+ Categorizes the error, if it is Facebook related, to simplify application mitigation behavior
+ 
+ @discussion
+ In general, in response to an error connecting to Facebook, an application should, retry the
+ operation, request permissions, reconnect the application, or prompt the user to take an action.
+ The error category can be used to understand the class of error received from Facebook.  For more infomation on this
+ see https://developers.facebook.com/docs/reference/api/errors/
+ */
+@property (readonly) FBErrorCategory fberrorCategory;
+
+/*!
+ @abstract
+ If YES indicates that a user action is required in order to successfully continue with the facebook operation
+ 
+ @discussion
+ In general if fberrorShouldNotifyUser is NO, then the application has a straightforward mitigation, such as
+ retry the operation or request permissions from the user, etc. In some cases it is necessary for the user to
+ take an action before the application continues to attempt a Facebook connection. For more infomation on this 
+ see https://developers.facebook.com/docs/reference/api/errors/
+ */
+@property (readonly) BOOL fberrorShouldNotifyUser;
+
+/*!
+ @abstract
+ A message suitable for display to the user, describing a user action necessary to enable Facebook functionality.
+ Not all Facebook errors yield a message suitable for user display; however in all cases where
+ fberrorShouldNotifyUser is YES, this property returns a localizable message suitable for display.
+ */
+@property (readonly, copy) NSString *fberrorUserMessage;
+
+@end

data/lib/vendor/FacebookSDK.framework/Versions/Current/Resources/Info.plist

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+  <dict>
+    <key>CFBundleDevelopmentRegion</key>
+    <string>English</string>
+    <key>CFBundleExecutable</key>
+    <string>FacebookSDK</string>
+    <key>CFBundleIdentifier</key>
+    <string>com.facebook.sdk</string>
+    <key>CFBundleInfoDictionaryVersion</key>
+    <string>1.0</string>
+    <key>CFBundlePackageType</key>
+    <string>FMWK</string>
+    <key>CFBundleSignature</key>
+    <string>????</string>
+    <key>CFBundleVersion</key>
+    <string>1.0</string>
+  </dict>
+</plist>

data/lib/vendor/Firebase.framework/Headers/FDataSnapshot.h

@@ -0,0 +1,146 @@
+/*
+ * Firebase iOS Client Library
+ *
+ * Copyright © 2013 Firebase - All Rights Reserved
+ * https://www.firebase.com
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ * list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binaryform must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ *
+ * THIS SOFTWARE IS PROVIDED BY FIREBASE AS IS AND ANY EXPRESS OR
+ * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
+ * EVENT SHALL FIREBASE BE LIABLE FOR ANY DIRECT,
+ * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+ * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+ * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
+ * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+
+#import <Foundation/Foundation.h>
+
+@class Firebase;
+
+/**
+ * An FDataSnapshot contains data from a Firebase location. Any time you read
+ * Firebase data, you receive the data as an FDataSnapshot.
+ *
+ * FDataSnapshots are passed to the blocks you attach with observeEventType:withBlock: or observeSingleEvent:withBlock:.
+ * They are efficiently-generated immutable copies of the data at a Firebase location.
+ * They can't be modified and will never change. To modify data at a location,
+ * use a Firebase reference (e.g. with setValue:).
+ */
+@interface FDataSnapshot : NSObject
+
+
+/** @name Navigating and inspecting a snapshot */
+
+/**
+ * Get an FDataSnapshot for the location at the specified relative path.
+ * The relative path can either be a simple child name (e.g. 'fred')
+ * or a deeper slash-separated path (e.g. 'fred/name/first'). If the child
+ * location has no data, an empty FDataSnapshot is returned.
+ *
+ * @param childPathString A relative path to the location of child data.
+ * @return The FDataSnapshot for the child location.
+ */
+- (FDataSnapshot *) childSnapshotForPath:(NSString *)childPathString;
+
+
+/**
+ * Return YES if the specified child exists.
+ *
+ * @param childPathString A relative path to the location of a potential child.
+ * @return YES if data exists at the specified childPathString, else false.
+ */
+- (BOOL) hasChild:(NSString *)childPathString;
+
+
+/**
+ * Return YES if the DataSnapshot has any children.
+ *
+ * @return YES if this snapshot has any children, else NO.
+ */
+- (BOOL) hasChildren;
+
+
+/** @name Data export */
+
+/**
+ * Returns the raw value at this location, coupled with any metadata, such as priority.
+ *
+ * Priorities, where they exist, are accessible under the ".priority" key in instances of NSDictionary.
+ * For leaf locations with priorities, the value will be under the ".value" key.
+ */
+- (id) valueInExportFormat;
+
+
+/** @name Properties */
+
+/**
+ * Returns the contents of this data snapshot as native types.
+ *
+ * Data types returned:
+ * * NSDictionary
+ * * NSArray
+ * * NSNumber (also includes booleans)
+ * * NSString
+ *
+ * @return The data as a native object.
+ */
+@property (strong, readonly, nonatomic) id value;
+
+
+/**
+ * Get the number of children for this DataSnapshot.
+ *
+ * @return An integer indicating the number of children.
+ */
+@property (readonly, nonatomic) NSUInteger childrenCount;
+
+
+/**
+ * Get a Firebase reference for the location that this data came from
+ *
+ * @return A Firebase instance for the location of this data
+ */
+@property (nonatomic, readonly, strong) Firebase* ref;
+
+
+/**
+ * The name of the location that generated this FDataSnapshot.
+ *
+ * @return An NSString containing the name for the location of this FDataSnapshot.
+ */
+@property (strong, readonly, nonatomic) NSString* name;
+
+
+/**
+ * An iterator for snapshots of the child nodes in this snapshot.
+ * You can use the native for..in syntax:
+ *
+ * for (FDataSnapshot* child in snapshot.children) {
+ *     ...
+ * }
+ *
+ * @return An NSEnumerator of the children
+ */
+@property (strong, readonly, nonatomic) NSEnumerator* children;
+
+/**
+ * The priority of the data in this FDataSnapshot.
+ *
+ * @return The priority as a string, or nil if no priority was set.
+ */
+@property (strong, readonly, nonatomic) id priority;
+
+@end