motion-firebase 1.0.5

data/lib/vendor/FacebookSDK.framework/Versions/Current/DeprecatedHeaders/FBRequestConnection.h

@@ -0,0 +1,389 @@
+/*
+ * 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 <CoreLocation/CoreLocation.h>
+#import "FBGraphObject.h"
+
+// up-front decl's
+@class FBRequest;
+@class FBRequestConnection;
+@class UIImage;
+
+/*!
+ Normally requests return JSON data that is parsed into a set of `NSDictionary`
+ and `NSArray` objects.
+
+ When a request returns a non-JSON response, that response is packaged in
+ a `NSDictionary` using FBNonJSONResponseProperty as the key and the literal
+ response as the value.
+*/
+extern NSString *const FBNonJSONResponseProperty;
+
+/*!
+ @typedef FBRequestHandler
+
+ @abstract
+ A block that is passed to addRequest to register for a callback with the results of that
+ request once the connection completes.
+
+ @discussion
+ Pass a block of this type when calling addRequest.  This will be called once
+ the request completes.  The call occurs on the UI thread.
+
+ @param connection      The `FBRequestConnection` that sent the request.
+
+ @param result          The result of the request.  This is a translation of
+                        JSON data to `NSDictionary` and `NSArray` objects.  This
+                        is nil if there was an error.
+
+ @param error           The `NSError` representing any error that occurred.
+
+*/
+typedef void (^FBRequestHandler)(FBRequestConnection *connection, 
+                                 id result,
+                                 NSError *error);
+
+/*!
+ @class FBRequestConnection
+
+ @abstract
+ The `FBRequestConnection` represents a single connection to Facebook to service a request.
+
+ @discussion
+ The request settings are encapsulated in a reusable <FBRequest> object. The 
+ `FBRequestConnection` object encapsulates the concerns of a single communication
+ e.g. starting a connection, canceling a connection, or batching requests.
+
+*/
+@interface FBRequestConnection : NSObject
+
+/*!
+ @methodgroup Creating a request
+*/
+
+/*!
+ @method
+
+ Calls <initWithTimeout:> with a default timeout of 180 seconds.
+*/
+- (id)init;
+
+/*!
+ @method
+
+ @abstract
+ `FBRequestConnection` objects are used to issue one or more requests as a single
+ request/response connection with Facebook.
+
+ @discussion
+ For a single request, the usual method for creating an `FBRequestConnection`
+ object is to call one of the **start* ** methods on <FBRequest>. However, it is
+ allowable to init an `FBRequestConnection` object directly, and call 
+ <addRequest:completionHandler:> to add one or more request objects to the 
+ connection, before calling start.
+ 
+ Note that if requests are part of a batch, they must have an open
+ FBSession that has an access token associated with it. Alternatively a default App ID
+ must be set either in the plist or through an explicit call to <[FBSession defaultAppID]>.
+
+ @param timeout         The `NSTimeInterval` (seconds) to wait for a response before giving up.
+*/
+     
+- (id)initWithTimeout:(NSTimeInterval)timeout;
+
+// properties
+
+/*!
+ @abstract
+ The request that will be sent to the server.
+
+ @discussion
+ This property can be used to create a `NSURLRequest` without using
+ `FBRequestConnection` to send that request.  It is legal to set this property 
+ in which case the provided `NSMutableURLRequest` will be used instead.  However,
+ the `NSMutableURLRequest` must result in an appropriate response.  Furthermore, once
+ this property has been set, no more <FBRequest> objects can be added to this
+ `FBRequestConnection`.
+*/
+@property(nonatomic, retain, readwrite) NSMutableURLRequest *urlRequest;
+
+/*!
+ @abstract
+ The raw response that was returned from the server.  (readonly)
+
+ @discussion
+ This property can be used to inspect HTTP headers that were returned from
+ the server.
+
+ The property is nil until the request completes.  If there was a response
+ then this property will be non-nil during the FBRequestHandler callback.
+*/
+@property(nonatomic, retain, readonly) NSHTTPURLResponse *urlResponse; 
+
+/*!
+ @methodgroup Adding requests
+*/
+
+/*!
+ @method
+ 
+ @abstract
+ This method adds an <FBRequest> object to this connection and then calls 
+ <start> on the connection.
+ 
+ @discussion
+ The completion handler is retained until the block is called upon the 
+ completion or cancellation of the connection.
+ 
+ @param request       A request to be included in the round-trip when start is called.
+ @param handler       A handler to call back when the round-trip completes or times out.
+*/
+- (void)addRequest:(FBRequest*)request
+ completionHandler:(FBRequestHandler)handler;
+
+/*!
+ @method
+
+ @abstract
+ This method adds an <FBRequest> object to this connection and then calls 
+ <start> on the connection.
+
+ @discussion
+ The completion handler is retained until the block is called upon the
+ completion or cancellation of the connection. This request can be named
+ to allow for using the request's response in a subsequent request.
+
+ @param request         A request to be included in the round-trip when start is called.
+
+ @param handler         A handler to call back when the round-trip completes or times out.
+ 
+ @param name            An optional name for this request.  This can be used to feed
+ the results of one request to the input of another <FBRequest> in the same 
+ `FBRequestConnection` as described in 
+ [Graph API Batch Requests]( https://developers.facebook.com/docs/reference/api/batch/ ). 
+*/
+- (void)addRequest:(FBRequest*)request
+ completionHandler:(FBRequestHandler)handler
+    batchEntryName:(NSString*)name;
+
+/*!
+ @methodgroup Instance methods
+*/
+
+/*!
+ @method
+
+ @abstract
+ This method starts a connection with the server and is capable of handling all of the 
+ requests that were added to the connection.
+
+ @discussion
+ Errors are reported via the handler callback, even in cases where no 
+ communication is attempted by the implementation of `FBRequestConnection`. In 
+ such cases multiple error conditions may apply, and if so the following
+ priority (highest to lowest) is used:
+
+ - `FBRequestConnectionInvalidRequestKey` -- this error is reported when an 
+ <FBRequest> cannot be encoded for transmission.
+
+ - `FBRequestConnectionInvalidBatchKey`   -- this error is reported when any
+ request in the connection cannot be encoded for transmission with the batch.
+ In this scenario all requests fail.
+  
+ This method cannot be called twice for an `FBRequestConnection` instance.
+*/
+- (void)start;
+
+/*!
+ @method
+
+ @abstract
+ Signals that a connection should be logically terminated as the
+ application is no longer interested in a response.
+
+ @discussion
+ Synchronously calls any handlers indicating the request was cancelled. Cancel
+ does not guarantee that the request-related processing will cease. It 
+ does promise that  all handlers will complete before the cancel returns. A call to
+ cancel prior to a start implies a cancellation of all requests associated
+ with the connection.
+*/
+- (void)cancel;
+
+/*!
+ @method
+ 
+ @abstract
+ Simple method to make a graph API request for user info (/me), creates an <FBRequest> 
+ then uses an <FBRequestConnection> object to start the connection with Facebook. The 
+ request uses the active session represented by `[FBSession activeSession]`.
+ 
+ See <connectionWithSession:graphPath:parameters:HTTPMethod:completionHandler:>
+ 
+ @param handler          The handler block to call when the request completes with a success, error, or cancel action.
+ */
++ (FBRequestConnection*)startForMeWithCompletionHandler:(FBRequestHandler)handler;
+
+/*!
+ @method
+ 
+ @abstract
+ Simple method to make a graph API request for user friends (/me/friends), creates an <FBRequest> 
+ then uses an <FBRequestConnection> object to start the connection with Facebook. The 
+ request uses the active session represented by `[FBSession activeSession]`.
+ 
+ See <connectionWithSession:graphPath:parameters:HTTPMethod:completionHandler:>
+ 
+ @param handler          The handler block to call when the request completes with a success, error, or cancel action.
+ */
++ (FBRequestConnection*)startForMyFriendsWithCompletionHandler:(FBRequestHandler)handler;
+
+/*!
+ @method
+ 
+ @abstract
+ Simple method to make a graph API post of a photo. The request  
+ uses the active session represented by `[FBSession activeSession]`.
+  
+ @param photo            A `UIImage` for the photo to upload.
+ @param handler          The handler block to call when the request completes with a success, error, or cancel action.
+ */
++ (FBRequestConnection*)startForUploadPhoto:(UIImage *)photo
+                          completionHandler:(FBRequestHandler)handler;
+
+/*!
+ @method
+ 
+ @abstract
+ Simple method to make a graph API post of a status update. The request  
+ uses the active session represented by `[FBSession activeSession]`.
+ 
+ @param message         The message to post.
+ @param handler          The handler block to call when the request completes with a success, error, or cancel action.
+ */
++ (FBRequestConnection *)startForPostStatusUpdate:(NSString *)message
+                                completionHandler:(FBRequestHandler)handler;
+
+/*!
+ @method
+ 
+ @abstract
+ Simple method to make a graph API post of a status update. The request  
+ uses the active session represented by `[FBSession activeSession]`.
+ 
+ @param message         The message to post.
+ @param place           The place to checkin with, or nil. Place may be an fbid or a 
+ graph object representing a place.
+ @param tags            Array of friends to tag in the status update, each element 
+ may be an fbid or a graph object representing a user.
+ @param handler          The handler block to call when the request completes with a success, error, or cancel action.
+ */
++ (FBRequestConnection *)startForPostStatusUpdate:(NSString *)message
+                                            place:(id)place
+                                             tags:(id<NSFastEnumeration>)tags
+                                completionHandler:(FBRequestHandler)handler;
+
+/*!
+ @method
+ 
+ @abstract
+ Starts a request representing a Graph API call to the "search" endpoint
+ for a given location using the active session.
+ 
+ @discussion
+ Simplifies starting a request to search for places near a coordinate.
+ 
+ This method creates the necessary <FBRequest> object and initializes and 
+ starts an <FBRequestConnection> object. A successful Graph API call will
+ return an array of <FBGraphPlace> objects representing the nearby locations.
+ 
+ @param coordinate      The search coordinates.
+ 
+ @param radius          The search radius in meters.
+ 
+ @param limit           The maxiumum number of results to return.  It is
+                        possible to receive fewer than this because of the 
+                        radius and because of server limits.
+ 
+ @param searchText      The text to use in the query to narrow the set of places
+                        returned.
+ @param handler          The handler block to call when the request completes with a success, error, or cancel action.
+ */
++ (FBRequestConnection*)startForPlacesSearchAtCoordinate:(CLLocationCoordinate2D)coordinate
+                                          radiusInMeters:(NSInteger)radius
+                                            resultsLimit:(NSInteger)limit
+                                              searchText:(NSString*)searchText
+                                       completionHandler:(FBRequestHandler)handler;
+
+/*!
+ @method
+ 
+ @abstract
+ Simple method to make a graph API request, creates an <FBRequest> object for then
+ uses an <FBRequestConnection> object to start the connection with Facebook. The 
+ request uses the active session represented by `[FBSession activeSession]`.
+ 
+ See <connectionWithSession:graphPath:parameters:HTTPMethod:completionHandler:>
+ 
+ @param graphPath        The Graph API endpoint to use for the request, for example "me".
+ @param handler          The handler block to call when the request completes with a success, error, or cancel action.
+ */
++ (FBRequestConnection*)startWithGraphPath:(NSString*)graphPath
+                         completionHandler:(FBRequestHandler)handler;
+
+/*!
+ @method
+ 
+ @abstract
+ Simple method to make post an object using the graph API, creates an <FBRequest> object for 
+ HTTP POST, then uses <FBRequestConnection> to start a connection with Facebook. The request uses
+ the active session represented by `[FBSession activeSession]`.
+ 
+ @param graphPath        The Graph API endpoint to use for the request, for example "me".
+ 
+ @param graphObject      An object or open graph action to post.
+ 
+ @param handler          The handler block to call when the request completes with a success, error, or cancel action.
+ */
++ (FBRequestConnection*)startForPostWithGraphPath:(NSString*)graphPath
+                                      graphObject:(id<FBGraphObject>)graphObject
+                                completionHandler:(FBRequestHandler)handler;
+
+/*!
+ @method
+ 
+ @abstract
+ Creates an `FBRequest` object for a Graph API call, instantiate an
+ <FBRequestConnection> object, add the request to the newly created
+ connection and finally start the connection. Use this method for
+ specifying the request parameters and HTTP Method. The request uses
+ the active session represented by `[FBSession activeSession]`.
+ 
+ @param graphPath        The Graph API endpoint to use for the request, for example "me".
+ 
+ @param parameters       The parameters for the request. A value of nil sends only the automatically handled parameters, for example, the access token. The default is nil.
+ 
+ @param HTTPMethod       The HTTP method to use for the request. A nil value implies a GET.
+ 
+ @param handler          The handler block to call when the request completes with a success, error, or cancel action.
+ */
++ (FBRequestConnection*)startWithGraphPath:(NSString*)graphPath
+                                parameters:(NSDictionary*)parameters
+                                HTTPMethod:(NSString*)HTTPMethod
+                         completionHandler:(FBRequestHandler)handler;
+
+@end

data/lib/vendor/FacebookSDK.framework/Versions/Current/DeprecatedHeaders/FBSBJSON.h

@@ -0,0 +1,75 @@
+/*
+ Copyright (C) 2007-2009 Stig Brautaset. All rights reserved.
+ 
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions are met:
+ 
+ * Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+ 
+ * Redistributions in binary form 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.
+ 
+ * Neither the name of the author nor the names of its contributors may be used
+   to endorse or promote products derived from this software without specific
+   prior written permission.
+ 
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "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 THE COPYRIGHT OWNER OR CONTRIBUTORS 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>
+#import "FBSBJsonParser.h"
+#import "FBSBJsonWriter.h"
+
+/**
+ @brief Facade for SBJsonWriter/SBJsonParser.
+
+ Requests are forwarded to instances of SBJsonWriter and SBJsonParser.
+ */
+@interface FBSBJSON : FBSBJsonBase <FBSBJsonParser, FBSBJsonWriter> {
+
+@private    
+    FBSBJsonParser *jsonParser;
+    FBSBJsonWriter *jsonWriter;
+}
+
+
+/// Return the fragment represented by the given string
+- (id)fragmentWithString:(NSString*)jsonrep
+                   error:(NSError**)error;
+
+/// Return the object represented by the given string
+- (id)objectWithString:(NSString*)jsonrep
+                 error:(NSError**)error;
+
+/// Parse the string and return the represented object (or scalar)
+- (id)objectWithString:(id)value
+           allowScalar:(BOOL)x
+    			 error:(NSError**)error;
+
+
+/// Return JSON representation of an array  or dictionary
+- (NSString*)stringWithObject:(id)value
+                        error:(NSError**)error;
+
+/// Return JSON representation of any legal JSON value
+- (NSString*)stringWithFragment:(id)value
+                          error:(NSError**)error;
+
+/// Return JSON representation (or fragment) for the given object
+- (NSString*)stringWithObject:(id)value
+                  allowScalar:(BOOL)x
+    					error:(NSError**)error;
+
+
+@end

data/lib/vendor/FacebookSDK.framework/Versions/Current/DeprecatedHeaders/FBSBJsonBase.h

@@ -0,0 +1,86 @@
+/*
+ Copyright (C) 2009 Stig Brautaset. All rights reserved.
+ 
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions are met:
+ 
+ * Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+ 
+ * Redistributions in binary form 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.
+ 
+ * Neither the name of the author nor the names of its contributors may be used
+   to endorse or promote products derived from this software without specific
+   prior written permission.
+ 
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "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 THE COPYRIGHT OWNER OR CONTRIBUTORS 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>
+
+extern NSString * FBSBJSONErrorDomain;
+
+
+enum {
+    EUNSUPPORTED = 1,
+    EPARSENUM,
+    EPARSE,
+    EFRAGMENT,
+    ECTRL,
+    EUNICODE,
+    EDEPTH,
+    EESCAPE,
+    ETRAILCOMMA,
+    ETRAILGARBAGE,
+    EEOF,
+    EINPUT
+};
+
+/**
+ @brief Common base class for parsing & writing.
+
+ This class contains the common error-handling code and option between the parser/writer.
+ */
+@interface FBSBJsonBase : NSObject {
+    NSMutableArray *errorTrace;
+
+@protected
+    NSUInteger depth, maxDepth;
+}
+
+/**
+ @brief The maximum recursing depth.
+ 
+ Defaults to 512. If the input is nested deeper than this the input will be deemed to be
+ malicious and the parser returns nil, signalling an error. ("Nested too deep".) You can
+ turn off this security feature by setting the maxDepth value to 0.
+ */
+@property NSUInteger maxDepth;
+
+/**
+ @brief Return an error trace, or nil if there was no errors.
+ 
+ Note that this method returns the trace of the last method that failed.
+ You need to check the return value of the call you're making to figure out
+ if the call actually failed, before you know call this method.
+ */
+ @property(copy,readonly) NSArray* errorTrace;
+
+/// @internal for use in subclasses to add errors to the stack trace
+- (void)addErrorWithCode:(NSUInteger)code description:(NSString*)str;
+
+/// @internal for use in subclasess to clear the error before a new parsing attempt
+- (void)clearErrorTrace;
+
+@end

data/lib/vendor/FacebookSDK.framework/Versions/Current/DeprecatedHeaders/FBSBJsonParser.h

@@ -0,0 +1,87 @@
+/*
+ Copyright (C) 2009 Stig Brautaset. All rights reserved.
+ 
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions are met:
+ 
+ * Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+ 
+ * Redistributions in binary form 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.
+ 
+ * Neither the name of the author nor the names of its contributors may be used
+   to endorse or promote products derived from this software without specific
+   prior written permission.
+ 
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "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 THE COPYRIGHT OWNER OR CONTRIBUTORS 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>
+#import "FBSBJsonBase.h"
+
+/**
+  @brief Options for the parser class.
+ 
+ This exists so the SBJSON facade can implement the options in the parser without having to re-declare them.
+ */
+@protocol FBSBJsonParser
+
+/**
+ @brief Return the object represented by the given string.
+ 
+ Returns the object represented by the passed-in string or nil on error. The returned object can be
+ a string, number, boolean, null, array or dictionary.
+ 
+ @param repr the json string to parse
+ */
+- (id)objectWithString:(NSString *)repr;
+
+@end
+
+
+/**
+ @brief The JSON parser class.
+ 
+ JSON is mapped to Objective-C types in the following way:
+ 
+ @li Null -> NSNull
+ @li String -> NSMutableString
+ @li Array -> NSMutableArray
+ @li Object -> NSMutableDictionary
+ @li Boolean -> NSNumber (initialised with -initWithBool:)
+ @li Number -> NSDecimalNumber
+ 
+ Since Objective-C doesn't have a dedicated class for boolean values, these turns into NSNumber
+ instances. These are initialised with the -initWithBool: method, and 
+ round-trip back to JSON properly. (They won't silently suddenly become 0 or 1; they'll be
+ represented as 'true' and 'false' again.)
+ 
+ JSON numbers turn into NSDecimalNumber instances,
+ as we can thus avoid any loss of precision. (JSON allows ridiculously large numbers.)
+ 
+ */
+@interface FBSBJsonParser : FBSBJsonBase <FBSBJsonParser> {
+    
+@private
+    const char *c;
+}
+
+@end
+
+// don't use - exists for backwards compatibility with 2.1.x only. Will be removed in 2.3.
+@interface FBSBJsonParser (Private)
+- (id)fragmentWithString:(id)repr;
+@end
+
+