motion-firebase 1.0.5

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

@@ -0,0 +1,271 @@
+/*
+ * 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 "FBSession.h"
+
+/*!
+ @typedef FBInsightsFlushBehavior enum
+ 
+ @abstract
+ Control when <FBInsights> sends log events to the server
+ 
+ @discussion
+ If an instance of an app doesn't send during its lifetime, or can't establish connectivity, the
+ events will be stashed for the next run and sent then.
+ */
+typedef enum {
+    
+    /*! Flush automatically: periodically and always at app reactivation. */
+    FBInsightsFlushBehaviorAuto,
+    
+    /*! Only flush when explicitFlush is called. When an app is moved to background/terminated, the
+     events are persisted and re-established at activation, but they will only be written with an
+     explicit flush. */
+    FBInsightsFlushBehaviorExplicitOnly,
+    
+} FBInsightsFlushBehavior;
+
+/*
+ * Constant used by NSNotificationCenter for results of flushing Insights event logs
+ */
+
+/*! NSNotificationCenter name indicating a result of a log flush attempt */
+extern NSString *const FBInsightsLoggingResultNotification;
+
+/*!
+ @class FBInsights
+ 
+ @abstract
+ Client-side event logging for specialized application analytics available through Facebook Insights 
+ and Conversion Pixel conversion tracking for ads optimization.
+ 
+ @discussion
+ The `FBInsights` static class has a few related roles:
+ 
+ + Logging predefined events to Facebook Application Insights with a
+ numeric value to sum across a large number of events, and an optional set of key/value
+ parameters that define "segments" for this event (e.g., 'purchaserStatus' : 'frequent', or
+ 'gamerLevel' : 'intermediate')
+ 
+ + Logging 'purchase' events to later be used for ads optimization around lifetime value.
+ 
+ + Logging 'conversion pixels' for use in ads conversion tracking and optimization.
+ 
+ + Methods that control the way in which events are flushed out to the Facebook servers.
+ 
+ Here are some important characteristics of the logging mechanism provided by `FBInsights`:
+ 
+ + Events are not sent immediately when logged.  They're cached and flushed out to the Facebook servers
+   in a number of situations:
+   - when an event count threshold is passed.
+   - when a time threshold is passed.
+   - when an app has gone to background and is then brought back to the foreground.
+ 
+ + Events will be accumulated when the app is in a disconnected state, and sent when the connection is
+   restored and one of the above 'flush' conditions are met.
+ 
+ + The `FBInsights` class in thread-safe in that events may be logged from any of the app's threads.
+ 
+ Some things to note when logging events:
+ 
+ + There is a limit to the number of unique parameter names in the provided parameters that can
+ be used per event, on the order of 10.  This is not just for an individual call, but for all
+ invocations for that eventName.
+ + Event names and parameter names (the keys in the NSDictionary) must be between 2 and 40 characters
+ + The length of each parameter value can be no more than on the order of 100 characters.
+ 
+ */
+@interface FBInsights : NSObject
+
+/*
+ * Global, session wide properties
+ */
+
+/*!
+ @method
+ 
+ @abstract
+ Gets the application version to the provided string.  Insights allows breakdown of
+ events by app version.
+ */
++ (NSString *)appVersion;
+
+/*!
+ @method
+ 
+ @abstract
+ Sets the application version to the provided string.  Insights allows breakdown of
+ events by app version.
+ 
+ @param appVersion  The version identifier of the iOS app that events are being logged through.
+ Enables analysis and breakdown of logged events by app version.
+ */
++ (void)setAppVersion:(NSString *)appVersion;
+
+/* 
+ * Purchase logging 
+ */
+
+/*!
+ @method
+ 
+ @abstract
+ Log a purchase of the specified amount, in the specified currency.  
+ 
+ @param purchaseAmount    Purchase amount to be logged, as expressed in the specified currency.
+ 
+ @param currency          Currency, is denoted as, e.g. "USD", "EUR", "GBP".  See ISO-4217 for 
+ specific values.  One reference for these is <http://en.wikipedia.org/wiki/ISO_4217>.
+ 
+ @discussion              This event immediately triggers a flush of the `FBInsights` event queue, unless the `flushBehavior` is set 
+ to `FBInsightsFlushBehaviorExplicitOnly`.
+ 
+ */
++ (void)logPurchase:(double)purchaseAmount
+           currency:(NSString *)currency;
+
+/*!
+ @method
+ 
+ @abstract
+ Log a purchase of the specified amount, in the specified currency, also providing a set of 
+ additional characteristics describing the purchase.
+ 
+ @param purchaseAmount  Purchase amount to be logged, as expressed in the specified currency.
+ 
+ @param currency        Currency, is denoted as, e.g. "USD", "EUR", "GBP".  See ISO-4217 for
+ specific values.  One reference for these is <http://en.wikipedia.org/wiki/ISO_4217>.
+ 
+ @param parameters      Arbitrary parameter dictionary of characteristics. The keys to this dictionary must
+ be NSString's, and the values are expected to be NSString or NSNumber.  Limitations on the number of
+ parameters and name construction are given in the `FBInsights` documentation.
+ 
+ @discussion              This event immediately triggers a flush of the `FBInsights` event queue, unless the `flushBehavior` is set
+ to `FBInsightsFlushBehaviorExplicitOnly`.
+
+ */
++ (void)logPurchase:(double)purchaseAmount
+           currency:(NSString *)currency
+         parameters:(NSDictionary *)parameters;
+
+/*!
+ @method
+ 
+ @abstract
+ Log a purchase of the specified amount, in the specified currency, also providing a set of
+ additional characteristics describing the purchase, as well as an <FBSession> to log to.
+ 
+ @param purchaseAmount  Purchase amount to be logged, as expressed in the specified currency.
+ 
+ @param currency        Currency, is denoted as, e.g. "USD", "EUR", "GBP".  See ISO-4217 for
+ specific values.  One reference for these is <http://en.wikipedia.org/wiki/ISO_4217>.
+ 
+ @param parameters      Arbitrary parameter dictionary of characteristics. The keys to this dictionary must
+ be NSString's, and the values are expected to be NSString or NSNumber.  Limitations on the number of
+ parameters and name construction are given in the `FBInsights` documentation.
+ 
+ @param session         <FBSession> to direct the event logging to, and thus be logged with whatever user (if any)
+ is associated with that <FBSession>.  A value of `nil` will use `[FBSession activeSession]`.
+ 
+ @discussion            This event immediately triggers a flush of the `FBInsights` event queue, unless the `flushBehavior` is set
+ to `FBInsightsFlushBehaviorExplicitOnly`.
+ 
+ */
++ (void)logPurchase:(double)purchaseAmount
+           currency:(NSString *)currency
+         parameters:(NSDictionary *)parameters
+            session:(FBSession *)session;
+
+/*
+ * Logging conversion pixels for Ads Optimization/Conversion Tracking.  See https://www.facebook.com/help/435189689870514 to learn more.
+ */
+
+/*!
+ @method
+ 
+ @abstract
+ Log, or "Fire" a Conversion Pixel.  Conversion Pixels are used for Ads Conversion Tracking.  See https://www.facebook.com/help/435189689870514 to learn more.
+ 
+ @param pixelID       Numeric ID for the conversion pixel to be logged.  See https://www.facebook.com/help/435189689870514 to learn how to create
+ a conversion pixel.
+ 
+ @param value         Value of what the logging of this pixel is worth to you.  The currency that this is expressed in doesn't matter, so long as it is consistent across all logging for this pixel.
+
+ @discussion          This event immediately triggers a flush of the `FBInsights` event queue, unless the `flushBehavior` is set
+ to `FBInsightsFlushBehaviorExplicitOnly`.
+ */
++ (void)logConversionPixel:(NSString *)pixelID
+              valueOfPixel:(double)value;
+
+/*!
+ @method
+ 
+ @abstract
+ Log, or "Fire" a Conversion Pixel.  Conversion Pixels are used for Ads Conversion Tracking.  See https://www.facebook.com/help/435189689870514 to learn more.
+ 
+ @param pixelID       Numeric ID for the conversion pixel to be logged.  See https://www.facebook.com/help/435189689870514 to learn how to create
+ a conversion pixel.
+ 
+ @param value         Value of what the logging of this pixel is worth to you.  The currency that this is expressed in doesn't matter, so long as it is consistent across all logging for this pixel.
+ 
+ @param session       <FBSession> to direct the event logging to, and thus be logged with whatever user (if any)
+ is associated with that <FBSession>.  A value of `nil` will use `[FBSession activeSession]`.
+ 
+ @discussion          This event immediately triggers a flush of the `FBInsights` event queue, unless the `flushBehavior` is set
+ to `FBInsightsFlushBehaviorExplicitOnly`.
+ 
+ */
++ (void)logConversionPixel:(NSString *)pixelID
+              valueOfPixel:(double)value
+                   session:(FBSession *)session;
+
+
+/*
+ * Control over event batching/flushing
+ */
+
+
+/*!
+ @method
+ 
+ @abstract
+ Get the current event flushing behavior specifying when events are sent back to Facebook servers.
+ */
++ (FBInsightsFlushBehavior)flushBehavior;
+
+/*!
+ @method
+ 
+ @abstract
+ Set the current event flushing behavior specifying when events are sent back to Facebook servers.
+ 
+ @param flushBehavior   The desired `FBInsightsFlushBehavior` to be used.
+ */
++ (void)setFlushBehavior:(FBInsightsFlushBehavior)flushBehavior;
+
+
+/*!
+ @method
+ 
+ @abstract
+ Explicitly kick off flushing of events to Facebook.  This is an asynchronous method, but it does initiate an immediate
+ kick off.  Server failures will be reported through the NotificationCenter with notification ID `FBInsightsLoggingResultNotification`.
+ */
++ (void)flush;
+
+
+@end

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

@@ -0,0 +1,178 @@
+/*
+ * Copyright 2010 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 "FBSession.h"
+#import "FBGraphUser.h"
+
+@protocol FBLoginViewDelegate;
+
+/*!
+ @class FBLoginView
+ @abstract FBLoginView is a custom UIView that renders a button to login or logout based on the
+  state of `FBSession.activeSession`
+ 
+ @discussion This view is closely associated with `FBSession.activeSession`. Upon initialization,
+  it will attempt to open an active session without UI if the current active session is not open.
+ 
+  The FBLoginView instance also monitors for changes to the active session.
+ */
+@interface FBLoginView : UIView
+
+/*!
+ @abstract
+ The permissions to login with.  Defaults to nil, meaning basic permissions.
+ 
+ @discussion Methods and properties that specify permissions without a read or publish
+ qualification are deprecated; use of a read-qualified or publish-qualified alternative is preferred.
+ */
+@property (readwrite, copy) NSArray *permissions __attribute__((deprecated));
+
+/*!
+ @abstract
+ The read permissions to request if the user logs in via this view.
+ 
+ @discussion
+ Note, that if read permissions are specified, then publish permissions should not be specified.
+ */
+@property (nonatomic, copy) NSArray *readPermissions;
+
+/*!
+ @abstract
+ The publish permissions to request if the user logs in via this view.
+ 
+ @discussion
+ Note, that a defaultAudience value of FBSessionDefaultAudienceOnlyMe, FBSessionDefaultAudienceEveryone, or
+ FBSessionDefaultAudienceFriends should be set if publish permissions are specified. Additionally, when publish
+ permissions are specified, then read should not be specified.
+ */
+@property (nonatomic, copy) NSArray *publishPermissions;
+
+/*!
+ @abstract
+ The default audience to use, if publish permissions are requested at login time.
+ */
+@property (nonatomic, assign) FBSessionDefaultAudience defaultAudience;
+
+
+/*!
+ @abstract
+ Initializes and returns an `FBLoginView` object.  The underlying session has basic permissions granted to it.
+ */
+- (id)init;
+
+/*!
+ @method
+ 
+ @abstract
+ Initializes and returns an `FBLoginView` object constructed with the specified permissions.
+ 
+ @param permissions  An array of strings representing the permissions to request during the
+ authentication flow. A value of nil will indicates basic permissions. 
+ 
+ @discussion Methods and properties that specify permissions without a read or publish
+ qualification are deprecated; use of a read-qualified or publish-qualified alternative is preferred.
+ */
+- (id)initWithPermissions:(NSArray *)permissions __attribute__((deprecated));
+
+/*!
+ @method
+ 
+ @abstract
+ Initializes and returns an `FBLoginView` object constructed with the specified permissions.
+ 
+ @param readPermissions  An array of strings representing the read permissions to request during the
+ authentication flow. A value of nil will indicates basic permissions.
+ 
+ */
+- (id)initWithReadPermissions:(NSArray *)readPermissions;
+
+/*!
+ @method
+ 
+ @abstract
+ Initializes and returns an `FBLoginView` object constructed with the specified permissions.
+ 
+ @param publishPermissions  An array of strings representing the publish permissions to request during the
+ authentication flow. 
+ 
+ @param defaultAudience  An audience for published posts; note that FBSessionDefaultAudienceNone is not valid
+ for permission requests that include publish or manage permissions.
+ 
+ */
+- (id)initWithPublishPermissions:(NSArray *)publishPermissions
+                 defaultAudience:(FBSessionDefaultAudience)defaultAudience;
+
+/*!
+ @abstract
+ The delegate object that receives updates for selection and display control.
+ */
+@property (nonatomic, assign) IBOutlet id<FBLoginViewDelegate> delegate;
+
+@end
+
+/*!
+ @protocol 
+ 
+ @abstract
+ The `FBLoginViewDelegate` protocol defines the methods used to receive event 
+ notifications from `FBLoginView` objects.
+ */
+@protocol FBLoginViewDelegate <NSObject>
+
+@optional
+
+/*!
+ @abstract
+ Tells the delegate that the view is now in logged in mode
+ 
+ @param loginView   The login view that transitioned its view mode
+ */
+- (void)loginViewShowingLoggedInUser:(FBLoginView *)loginView;
+
+/*!
+ @abstract
+ Tells the delegate that the view is has now fetched user info
+
+ @param loginView   The login view that transitioned its view mode
+ 
+ @param user        The user info object describing the logged in user
+ */
+- (void)loginViewFetchedUserInfo:(FBLoginView *)loginView
+                            user:(id<FBGraphUser>)user;
+
+/*!
+ @abstract
+ Tells the delegate that the view is now in logged out mode
+ 
+ @param loginView   The login view that transitioned its view mode
+ */
+- (void)loginViewShowingLoggedOutUser:(FBLoginView *)loginView;
+
+/*!
+ @abstract
+ Tells the delegate that there is a communication or authorization error.
+ 
+ @param loginView           The login view that transitioned its view mode
+ @param error               An error object containing details of the error.
+ @discussion See https://developers.facebook.com/docs/technical-guides/iossdk/errors/
+ for error handling best practices.
+ */
+- (void)loginView:(FBLoginView *)loginView
+      handleError:(NSError *)error;
+
+@end
+

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

@@ -0,0 +1,170 @@
+/*
+ * 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 <CoreLocation/CoreLocation.h>
+
+@class FBSession;
+
+/*!
+ @typedef FBNativeDialogResult 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. */
+    FBNativeDialogResultSucceeded,
+    /*! Indicates that the dialog action was cancelled (either by the user or the system). */
+    FBNativeDialogResultCancelled,
+    /*! Indicates that the dialog could not be shown (because not on ios6 or ios6 auth was not used). */
+    FBNativeDialogResultError
+} FBNativeDialogResult;
+
+/*!
+ @typedef
+ 
+ @abstract Defines a handler that will be called in response to the native share dialog
+ being displayed.
+ */
+typedef void (^FBShareDialogHandler)(FBNativeDialogResult result, NSError *error);
+
+/*!
+ @class FBNativeDialogs
+ 
+ @abstract
+ Provides methods to display native (i.e., non-Web-based) dialogs to the user.
+ Currently the iOS 6 sharing dialog is supported.
+*/ 
+@interface FBNativeDialogs : NSObject
+
+/*!
+ @abstract
+ Presents a dialog that allows the user to share a status update that may include
+ text, images, or URLs. This dialog is only available on iOS 6.0 and above. The
+ current active session returned by [FBSession activeSession] will be used to determine
+ whether the dialog will be displayed. If a session is active, it must be open and the
+ login method used to authenticate the user must be native iOS 6.0 authentication.
+ If no session active, then whether the call succeeds or not will depend on
+ whether Facebook integration has been configured.
+ 
+ @param viewController  The view controller which will present the dialog.
+ 
+ @param initialText The text which will initially be populated in the dialog. The user
+ will have the opportunity to edit this text before posting it. May be nil.
+ 
+ @param image  A UIImage that will be attached to the status update. May be nil.
+ 
+ @param url    An NSURL that will be attached to the status update. May be nil.
+ 
+ @param handler A handler that will be called when the dialog is dismissed, or if an error
+ occurs. May be nil.
+ 
+ @return YES if the dialog was presented, NO if not (in the case of a NO result, the handler
+ will still be called, with an error indicating the reason the dialog was not displayed)
+ */
++ (BOOL)presentShareDialogModallyFrom:(UIViewController*)viewController
+                          initialText:(NSString*)initialText
+                                image:(UIImage*)image
+                                  url:(NSURL*)url
+                              handler:(FBShareDialogHandler)handler;
+
+/*!
+ @abstract
+ Presents a dialog that allows the user to share a status update that may include
+ text, images, or URLs. This dialog is only available on iOS 6.0 and above. The
+ current active session returned by [FBSession activeSession] will be used to determine
+ whether the dialog will be displayed. If a session is active, it must be open and the
+ login method used to authenticate the user must be native iOS 6.0 authentication. 
+ If no session active, then whether the call succeeds or not will depend on
+ whether Facebook integration has been configured.
+ 
+ @param viewController  The view controller which will present the dialog.
+ 
+ @param initialText The text which will initially be populated in the dialog. The user
+ will have the opportunity to edit this text before posting it. May be nil.
+ 
+ @param images  An array of UIImages that will be attached to the status update. May
+ be nil.
+ 
+ @param urls    An array of NSURLs that will be attached to the status update. May be nil.
+ 
+ @param handler A handler that will be called when the dialog is dismissed, or if an error
+ occurs. May be nil.
+ 
+ @return YES if the dialog was presented, NO if not (in the case of a NO result, the handler
+ will still be called, with an error indicating the reason the dialog was not displayed)
+ */
++ (BOOL)presentShareDialogModallyFrom:(UIViewController*)viewController
+                          initialText:(NSString*)initialText
+                               images:(NSArray*)images
+                                 urls:(NSArray*)urls
+                              handler:(FBShareDialogHandler)handler;
+
+/*!
+ @abstract
+ Presents a dialog that allows the user to share a status update that may include
+ text, images, or URLs. This dialog is only available on iOS 6.0 and above. An
+ <FBSession> may be specified, or nil may be passed to indicate that the current
+ active session should be used. If a session is specified (whether explicitly or by
+ virtue of being the active session), it must be open and the login method used to
+ authenticate the user must be native iOS 6.0 authentication. If no session is specified
+ (and there is no active session), then whether the call succeeds or not will depend on
+ whether Facebook integration has been configured.
+ 
+ @param viewController  The view controller which will present the dialog.
+ 
+ @param session     The <FBSession> to use to determine whether or not the user has been
+ authenticated with iOS native authentication. If nil, then [FBSession activeSession]
+ will be checked. See discussion above for the implications of nil or non-nil session.
+ 
+ @param initialText The text which will initially be populated in the dialog. The user
+ will have the opportunity to edit this text before posting it. May be nil.
+ 
+ @param images  An array of UIImages that will be attached to the status update. May
+ be nil.
+ 
+ @param urls    An array of NSURLs that will be attached to the status update. May be nil.
+ 
+ @param handler A handler that will be called when the dialog is dismissed, or if an error
+ occurs. May be nil.
+ 
+ @return YES if the dialog was presented, NO if not (in the case of a NO result, the handler
+ will still be called, with an error indicating the reason the dialog was not displayed)
+ */
++ (BOOL)presentShareDialogModallyFrom:(UIViewController*)viewController
+                              session:(FBSession*)session
+                          initialText:(NSString*)initialText
+                               images:(NSArray*)images
+                                 urls:(NSArray*)urls
+                              handler:(FBShareDialogHandler)handler;
+
+/*!
+ @abstract
+ Determines whether a call to presentShareDialogModallyFrom: will successfully present
+ a dialog. This is useful for applications that need to modify the available UI controls
+ depending on whether the dialog is available on the current platform and for the current
+ user.
+ 
+ @param session     The <FBSession> to use to determine whether or not the user has been
+ authenticated with iOS native authentication. If nil, then [FBSession activeSession]
+ will be checked. See discussion above for the implications of nil or non-nil session.
+ 
+ @return YES if the dialog would be presented for the session, and NO if not
+ */
++ (BOOL)canPresentShareDialogWithSession:(FBSession*)session;
+
+@end