djanowski-mmangino-facebooker 1.0.4

data/lib/facebooker/model.rb

@@ -0,0 +1,123 @@
+module Facebooker
+  ##
+  # helper methods primarily supporting the management of Ruby objects which are populatable via Hashes.  
+  # Since most Facebook API calls accept and return hashes of data (as XML), the Model module allows us to
+  # directly populate a model's attributes given a Hash with matching key names.
+  module Model
+    class UnboundSessionException < Exception; end
+    def self.included(includer)
+      includer.extend ClassMethods
+      includer.__send__(:attr_writer, :session)
+      includer.__send__(:attr_reader, :anonymous_fields)
+    end
+    module ClassMethods
+      ##
+      # Instantiate a new instance of the class into which we are included and populate that instance's
+      # attributes given the provided Hash.  Key names in the Hash should map to attribute names on the model.
+      def from_hash(hash)
+        instance = new(hash)
+        yield instance if block_given?
+        instance
+      end
+      
+      ##
+      # Create a standard attr_writer and a populating_attr_reader      
+      def populating_attr_accessor(*symbols)
+        attr_writer *symbols
+        populating_attr_reader *symbols
+      end
+
+      ## 
+      # Create a reader that will attempt to populate the model if it has not already been populated
+      def populating_attr_reader(*symbols)
+        symbols.each do |symbol|
+          define_method(symbol) do
+            populate unless populated?
+            instance_variable_get("@#{symbol}")
+          end
+        end
+      end
+      
+      def populating_hash_settable_accessor(symbol, klass)
+        populating_attr_reader symbol
+        hash_settable_writer(symbol, klass)
+      end
+        
+      def populating_hash_settable_list_accessor(symbol, klass)
+        populating_attr_reader symbol
+        hash_settable_list_writer(symbol, klass)
+      end
+      
+      #
+      # Declares an attribute named ::symbol:: which can be set with either an instance of ::klass::
+      # or a Hash which will be used to populate a new instance of ::klass::.
+      def hash_settable_accessor(symbol, klass)
+        attr_reader symbol
+        hash_settable_writer(symbol, klass)
+      end
+      
+      def hash_settable_writer(symbol, klass)
+        define_method("#{symbol}=") do |value|
+          instance_variable_set("@#{symbol}", value.kind_of?(Hash) ? klass.from_hash(value) : value)
+        end        
+      end
+      
+      #
+      # Declares an attribute named ::symbol:: which can be set with either a list of instances of ::klass::
+      # or a list of Hashes which will be used to populate a new instance of ::klass::.      
+      def hash_settable_list_accessor(symbol, klass)
+        attr_reader symbol
+        hash_settable_list_writer(symbol, klass)
+      end
+      
+      def hash_settable_list_writer(symbol, klass)
+        define_method("#{symbol}=") do |list|
+          instance_variable_set("@#{symbol}", list.map do |item|
+            item.kind_of?(Hash) ? klass.from_hash(item) : item
+          end)
+        end
+      end      
+    end
+    
+    ##
+    # Centralized, error-checked place for a model to get the session to which it is bound.
+    # Any Facebook API queries require a Session instance.
+    def session
+      @session || (raise UnboundSessionException, "Must bind this object to a Facebook session before querying")
+    end
+    
+    # 
+    # This gets populated from FQL queries.
+    def anon=(value)
+      @anonymous_fields = value
+    end
+    
+    def initialize(hash = {})
+      populate_from_hash!(hash)
+    end
+
+    def populate
+      raise NotImplementedError, "#{self.class} included me and should have overriden me"
+    end
+
+    def populated?
+      !@populated.nil?
+    end
+    
+    ##
+    # Set model's attributes via Hash.  Keys should map directly to the model's attribute names.
+    def populate_from_hash!(hash)
+      unless hash.empty?
+        hash.each do |key, value|
+          set_attr_method = "#{key}="
+          if respond_to?(set_attr_method)
+            self.__send__(set_attr_method, value) 
+          else
+            Facebooker::Logging.log_info("**Warning**, Attempt to set non-attribute: #{key}",hash)
+          end
+        end
+        @populated = true
+      end      
+    end    
+  end
+end

data/lib/facebooker/models/affiliation.rb

@@ -0,0 +1,10 @@
+require 'facebooker/model'
+module Facebooker
+  ##
+  # Represents a user's affiliation, for example, which educational institutions
+  # the user is associated with.
+  class Affiliation
+    include Model
+    attr_accessor :name, :status, :type, :year, :nid
+  end
+end

data/lib/facebooker/models/album.rb

@@ -0,0 +1,11 @@
+require 'facebooker/model'
+module Facebooker
+  ##
+  # A simple representation of a photo album.
+  class Album
+    include Model
+    attr_accessor :aid, :cover_pid, :owner, :name, :created,
+                  :modified, :description, :location, :link, :size
+
+  end
+end

data/lib/facebooker/models/applicationproperties.rb

@@ -0,0 +1,39 @@
+module Facebooker
+  
+  # application_name  string   The name of your application.  
+  # callback_url  string   Your application's callback URL. The callback URL cannot be longer than 100 characters.  
+  # post_install_url  string   The URL where a user gets redirected after installing your application. The post-install URL cannot be longer than 100 characters. 
+  # edit_url  string    
+  # dashboard_url string    
+  # uninstall_url string   The URL where a user gets redirected after removing your application.  
+  # ip_list string   For Web-based applications, these are the IP addresses of your servers that can access Facebook's servers and serve information to your application. 
+  # email string   The email address associated with the application; the email address Facebook uses to contact you about your application. (default value is your Facebook email address.)  
+  # description string   The description of your application. 
+  # use_iframe  bool   Indicates whether you render your application with FBML (0) or in an iframe (1). (default value is 1)  
+  # desktop bool   Indicates whether your application is Web-based (0) or gets installed on a user's desktop (1). (default value is 1)  
+  # is_mobile bool   Indicates whether your application can run on a mobile device (1) or not (0). (default value is 1) 
+  # default_fbml  string   The default FBML code that appears in the user's profile box when he or she adds your application. 
+  # default_column  bool   Indicates whether your application appears in the wide (1) or narrow (0) column of a user's Facebook profile. (default value is 1) 
+  # message_url string   For applications that can create attachments, this is the URL where you store the attachment's content.  
+  # message_action  string   For applications that can create attachments, this is the label for the action that creates the attachment. It cannot be more than 20 characters.  
+  # about_url string   This is the URL to your application's About page. About pages are now Facebook Pages.  
+  # private_install bool   Indicates whether you want to disable (1) or enable (0) News Feed and Mini-Feed stories when a user installs your application. (default value is 1)  
+  # installable bool   Indicates whether a user can (1) or cannot (0) install your application. (default value is 1)  
+  # privacy_url string   The URL to your application's privacy terms. 
+  # help_url  string   The URL to your application's help page. 
+  # see_all_url string    
+  # tos_url string   The URL to your application's Terms of Service.  
+  # dev_mode  bool   Indicates whether developer mode is enabled (1) or disabled (0). Only developers can install applications in developer mode. (default value is 1)  
+  # preload_fql string   A preloaded FQL query.
+  class ApplicationProperties
+    include Model
+    FIELDS = [ :application_name, :callback_url, :post_install_url, :edit_url, :dashboard_url,
+               :uninstall_url, :ip_list, :email, :description, :use_iframe, :desktop, :is_mobile,
+               :default_fbml, :default_column, :message_url, :message_action, :about_url,
+               :private_install, :installable, :privacy_url, :help_url, :see_all_url, :tos_url,
+               :dev_mode, :preload_fql, :icon_url, :canvas_name, :logo_url, :connect_logo_url ]
+    
+    attr_accessor *FIELDS
+         
+  end
+end

data/lib/facebooker/models/cookie.rb

@@ -0,0 +1,10 @@
+require 'facebooker/model'
+module Facebooker
+  
+  ##
+  # A simple representation of a cookie.
+  class Cookie
+    include Model
+    attr_accessor :uid, :name, :value, :expires, :path
+  end
+end

data/lib/facebooker/models/education_info.rb

@@ -0,0 +1,11 @@
+module Facebooker
+  class EducationInfo
+    class HighschoolInfo
+      include Model
+      attr_accessor :hs1_id, :hs2_id, :grad_year, :hs1_name, :hs2_name
+    end
+    
+    include Model
+    attr_accessor :concentrations, :name, :year, :degree
+  end
+end

data/lib/facebooker/models/event.rb

@@ -0,0 +1,26 @@
+require 'facebooker/model'
+module Facebooker
+  class Event
+    
+    ##
+    # The relationship between a Facebook user and an Event to which he or she has been
+    # invited and may or may not be attending (based on #rsvp_status)
+    class Attendance
+      include Model
+      attr_accessor :eid, :uid, :rsvp_status
+      
+      ##
+      # Get the full, populated Event object which this Attendance is associated with.
+      # First access will query the Facebook API (facebook.events.get).  Subsequent
+      # calls are retrieved from in-memory cache.
+      def event
+        @event ||= Event.from_hash(session.post('facebook.events.get', :eids => [eid]).first)
+      end
+      
+      #TODO: implement user() method
+    end
+    
+    include Model
+    attr_accessor :eid, :pic, :pic_small, :pic_big, :name, :creator, :update_time, :description, :tagline, :venue, :host, :event_type, :nid, :location, :end_time, :start_time, :event_subtype
+  end
+end

data/lib/facebooker/models/friend_list.rb

@@ -0,0 +1,14 @@
+require 'facebooker/model'
+module Facebooker
+  ##
+  # A simple representation of a friend list.
+  class FriendList
+    include Model
+    attr_accessor :flid, :name
+    
+    # We need this to be an integer, so do the conversion
+    def flid=(f)
+      @flid= ( f.nil? ? nil : f.to_i)
+    end
+  end
+end

data/lib/facebooker/models/group.rb

@@ -0,0 +1,35 @@
+require 'facebooker/model'
+module Facebooker
+  class Group
+    ##
+    # The model of a user's relationship to a group.  Users can occupy different positions within a group (e.g. 'owner')
+    class Membership
+      include Model
+      attr_accessor :position, :gid, :uid
+    end
+    include Model
+    attr_accessor :pic, :pic_small, :pic_big, :name, :creator, :recent_news, :gid, :update_time, :group_subtype, :group_type, :website, :office, :description, :venue, :nid
+    
+    
+    ##
+    # Get the full list of members as populated User objects.  First time fetches group members via Facebook API call.  
+    # Subsequent calls return cached values.
+    # This is a convenience method for getting all of the Membership instances and instantiating User instances for each Membership.
+    def members
+      @members ||= memberships.map do |membership|
+        User.new(membership.uid, session)
+      end
+    end
+    
+    ##
+    # Get a list of Membership instances associated with this Group.  First call retrieves the Membership instances via a Facebook
+    # API call.  Subsequent calls are retrieved from in-memory cache.
+    def memberships
+      @memberships ||= session.post('facebook.groups.getMembers', :gid => gid).map do |hash|
+        Membership.from_hash(hash) do |membership|
+          membership.gid = gid
+        end
+      end
+    end
+  end
+end

data/lib/facebooker/models/info_item.rb

@@ -0,0 +1,10 @@
+module Facebooker
+  class InfoItem
+    include Model
+    attr_accessor :label, :image, :description, :link, :sublabel
+    
+    def to_json
+      {:label => label, :image => image, :description => description, :link => link, :sublabel => sublabel}.to_json
+    end
+  end
+end

data/lib/facebooker/models/info_section.rb

@@ -0,0 +1,10 @@
+module Facebooker
+  class InfoSection
+    include Model
+    attr_accessor :field, :items
+    
+    def to_json
+      {:field => field, :items => items}.to_json
+    end
+  end
+end

data/lib/facebooker/models/location.rb

@@ -0,0 +1,8 @@
+module Facebooker
+  ##
+  # Representation of Location used in all places where a Location is specified.
+  class Location
+    include Model
+    attr_accessor :city, :zip, :country, :state
+  end
+end

data/lib/facebooker/models/notifications.rb

@@ -0,0 +1,17 @@
+module Facebooker
+  class Notifications
+    include Model
+    attr_accessor :messages, :group_invites, :pokes, :friend_requests, :event_invites, :shares
+    
+    [:Messages, :Pokes, :Shares].each do |notification_type|
+      const_set(notification_type, Class.new do
+        include Model
+        attr_accessor :unread, :most_recent
+      end)
+      attribute_name = "#{notification_type.to_s.downcase}"
+      define_method("#{attribute_name}=") do |value|
+        instance_variable_set("@#{attribute_name}", value.kind_of?(Hash) ? Notifications.const_get(notification_type).from_hash(value) : value)
+      end
+    end
+  end
+end

data/lib/facebooker/models/page.rb

@@ -0,0 +1,27 @@
+require 'facebooker/model'
+module Facebooker
+  class Page
+
+    class Genre
+      include Model
+      FIELDS = [ :dance, :party, :relax, :talk, :think, :workout, :sing, :intimate, :raunchy, :headphones ]
+      attr_accessor *FIELDS
+
+      def initialize(*args)
+        super
+
+        # convert '1'/'0' to true/false
+        FIELDS.each do |field|
+          self.send("#{field}=", self.send(field) == '1')
+        end
+      end
+    end
+
+    include Model
+    attr_accessor :page_id, :name, :pic_small, :pic_big, :pic_square, :pic_large, :type, :type, :website, :location, :hours, :band_members, :bio, :hometown, :genre, :record_label, :influences, :has_added_app, :founded, :company_overview, :mission, :products, :release_date, :starring, :written_by, :directed_by, :produced_by, :studio, :awards, :plot_outline, :network, :season, :schedule
+
+    def genre=(value)
+      @genre = value.kind_of?(Hash) ? Genre.from_hash(value) : value
+    end
+  end
+end

data/lib/facebooker/models/photo.rb

@@ -0,0 +1,10 @@
+require 'facebooker/model'
+module Facebooker
+  class Photo
+    include Model
+    attr_accessor :pid, :aid, :owner, :title,
+                  :link, :caption, :created,
+                  :src, :src_big, :src_small,
+                  :story_fbid
+  end
+end

data/lib/facebooker/models/tag.rb

@@ -0,0 +1,12 @@
+require 'facebooker/model'
+module Facebooker
+  class Tag
+    include Model
+    attr_accessor :pid, :subject, :xcoord, :ycoord
+    
+    def coordinates
+      [xcoord, ycoord]
+    end
+    
+  end
+end

data/lib/facebooker/models/user.rb

@@ -0,0 +1,367 @@
+require 'facebooker/model'
+require 'facebooker/models/affiliation'
+require 'facebooker/models/work_info'
+module Facebooker
+  # 
+  # Holds attributes and behavior for a Facebook User
+  class User
+    include Model
+    class Status
+      include Model
+      attr_accessor :message, :time, :status_id
+    end
+    FIELDS = [:status, :political, :pic_small, :name, :quotes, :is_app_user, :tv, :profile_update_time, :meeting_sex, :hs_info, :timezone, :relationship_status, :hometown_location, :about_me, :wall_count, :significant_other_id, :pic_big, :music, :uid, :work_history, :sex, :religion, :notes_count, :activities, :pic_square, :movies, :has_added_app, :education_history, :birthday, :first_name, :meeting_for, :last_name, :interests, :current_location, :pic, :books, :affiliations]
+    STANDARD_FIELDS = [:uid, :first_name, :last_name, :name, :timezone, :birthday, :sex, :affiliations, :locale, :profile_url]
+    attr_accessor :id, :session
+    populating_attr_accessor *FIELDS
+    attr_reader :affiliations
+    populating_hash_settable_accessor :current_location, Location
+    populating_hash_settable_accessor :hometown_location, Location
+    populating_hash_settable_accessor :hs_info, EducationInfo::HighschoolInfo
+    populating_hash_settable_accessor :status, Status
+    populating_hash_settable_list_accessor :affiliations, Affiliation
+    populating_hash_settable_list_accessor :education_history, EducationInfo
+    populating_hash_settable_list_accessor :work_history, WorkInfo
+    
+    # Can pass in these two forms:
+    # id, session, (optional) attribute_hash
+    # attribute_hash
+    def initialize(*args)
+      if (args.first.kind_of?(String) || args.first.kind_of?(Integer)) && args.size==1
+        @id=Integer(args.shift)
+        @session = Session.current
+      elsif (args.first.kind_of?(String) || args.first.kind_of?(Integer)) && args[1].kind_of?(Session)
+        @id = Integer(args.shift)
+        @session = args.shift
+      end
+      if args.last.kind_of?(Hash)
+        populate_from_hash!(args.pop)
+      end     
+    end
+
+    # Returns a user's events, params correspond to API call parameters (except UID):
+    # http://wiki.developers.facebook.com/index.php/Events.get
+    # E.g:
+    #  @user.events(:start_time => Time.now, :end_time => 1.month.from_now)
+    #  # => Returns events betwen now and a month from now
+    def events(params={})
+      @events ||= {}
+      [:start_time,:end_time].compact.each do |key|
+        params[key] = params[key].to_i
+      end
+#      puts @events[params.to_s].nil?
+      @events[params.to_s] ||= @session.post('facebook.events.get', {:uid => self.id}.merge(params)).map do |event|
+        Event.from_hash(event)
+      end
+    end    
+    
+    # 
+    # Set the list of friends, given an array of User objects.  If the list has been retrieved previously, will not set
+    def friends=(list_of_friends,flid=nil)
+      @friends_hash ||= {}
+     	flid=cast_to_friend_list_id(flid)
+     	#use __blank instead of nil so that this is cached
+     	cache_key = flid||"__blank"
+     	
+      @friends_hash[cache_key] ||= list_of_friends
+    end
+    
+    def cast_to_friend_list_id(flid)
+      case flid
+ 	    when String
+ 	      list=friend_lists.detect {|f| f.name==flid}
+ 	      raise Facebooker::Session::InvalidFriendList unless list
+ 	      list.flid
+ 	    when FriendList
+ 	      flid.flid
+ 	    else
+ 	      flid
+ 	    end
+ 	  end
+    ##
+    # Retrieve friends
+    def friends(flid = nil)
+     	@friends_hash ||= {}
+     	flid=cast_to_friend_list_id(flid)
+      
+     	#use __blank instead of nil so that this is cached
+     	cache_key = flid||"__blank"
+     	@friends_hash[cache_key] ||= @session.post('facebook.friends.get', (flid.nil? ? {} : {:flid => flid})).map do |uid|
+          User.new(uid, @session)
+      end
+      @friends_hash[cache_key]
+    end
+    
+     def friend_lists    
+       @friend_lists ||= @session.post('facebook.friends.getLists').map do |hash|
+         friend_list = FriendList.from_hash(hash)                               
+         friend_list.session = session                                          
+         friend_list                                                            
+       end                                                                      
+     end
+    ###
+    # Retrieve friends with user info populated
+    # Subsequent calls will be retrieved from memory.
+    # Optional: list of fields to retrieve as symbols
+    def friends!(*fields)
+      @friends ||= session.post('facebook.users.getInfo', :fields => collect(fields), :uids => friends.map{|f| f.id}.join(',')).map do |hash|  
+        User.new(hash['uid'], session, hash)
+      end
+    end
+    
+    ###
+    # Retrieve profile data for logged in user
+    # Optional: list of fields to retrieve as symbols
+    def populate(*fields)
+      session.post('facebook.users.getInfo', :fields => collect(fields), :uids => id) do |response|
+        populate_from_hash!(response.first)
+      end
+    end
+        
+    def friends_with?(user_or_id)
+      friends.map{|f| f.to_i}.include?(user_or_id.to_i)  
+    end
+    
+    def friends_with_this_app
+      @friends_with_this_app ||= session.post('facebook.friends.getAppUsers').map do |uid|
+        User.new(uid, session)
+      end
+    end
+    
+    def groups(gids = [])
+      args = gids.empty? ? {} : {:gids => gids}
+      @groups ||= session.post('facebook.groups.get', args).map do |hash|
+        group = Group.from_hash(hash)
+        group.session = session
+        group
+      end
+    end
+    
+    def notifications
+      @notifications ||= Notifications.from_hash(session.post('facebook.notifications.get'))
+    end
+    
+    def publish_story(story)
+      publish(story)
+    end
+    
+    def publish_action(action)
+      publish(action)
+    end
+    
+    def publish_templatized_action(action)
+      publish(action)
+    end
+    
+    def albums
+      @albums ||= session.post('facebook.photos.getAlbums', :uid => self.id) do |response|
+        response.map do |hash|
+          Album.from_hash(hash)
+        end
+      end
+    end
+    
+    def create_album(params)
+      @album = session.post('facebook.photos.createAlbum', params) {|response| Album.from_hash(response)}
+    end
+    
+    def profile_photos
+      session.get_photos(nil, nil, profile_pic_album_id)
+    end
+    
+    def upload_photo(multipart_post_file)
+      Photo.from_hash(session.post_file('facebook.photos.upload', {nil => multipart_post_file}))
+    end
+    
+    def profile_fbml
+      session.post('facebook.profile.getFBML', :uid => @id)  
+    end    
+    
+    ##
+    # Set the profile FBML for this user
+    #
+    # This does not set profile actions, that should be done with profile_action=
+    def profile_fbml=(markup)
+      set_profile_fbml(markup, nil, nil)
+    end
+    
+    ##
+    # Set the mobile profile FBML
+    def mobile_fbml=(markup)
+      set_profile_fbml(nil, markup, nil)
+    end
+    
+    def profile_action=(markup)
+      set_profile_fbml(nil, nil, markup)
+    end
+    
+    def profile_main=(markup)
+     set_profile_fbml(nil,nil,nil,markup)
+    end
+    
+    def set_profile_fbml(profile_fbml, mobile_fbml, profile_action_fbml, profile_main = nil)
+      parameters = {:uid => @id}
+      parameters[:profile] = profile_fbml if profile_fbml
+      parameters[:profile_action] = profile_action_fbml if profile_action_fbml
+      parameters[:mobile_profile] = mobile_fbml if mobile_fbml
+      parameters[:profile_main] = profile_main if profile_main
+      session.post('facebook.profile.setFBML', parameters,false)
+    end
+    
+    ## ** NEW PROFILE DESIGN ***
+    # Set a info section for this user
+    #
+    # Note: using set_profile_info as I feel using user.set_info could be confused with the user.getInfo facebook method.
+    #       Also, I feel it fits in line with user.set_profile_fbml.
+    def set_profile_info(title, info_fields, format = :text)
+      session.post('facebook.profile.setInfo', :title => title, :uid => @id, 
+        :type => format.to_s == "text" ? 1 : 5, :info_fields => info_fields.to_json)
+    end
+    
+    def get_profile_info
+      session.post('facebook.profile.getInfo', :uid => @id)
+    end
+    
+    ##
+    # This DOES NOT set the status of a user on Facebook
+    # Use the set_status method instead
+    def status=(message)
+      case message
+      when String,Status
+        @status = message
+      when Hash
+        @status = Status.from_hash(message)
+      end
+    end
+    
+    ##
+    # Set the status for a user
+    # DOES NOT prepend "is" to the message
+    #
+    # requires extended permission. 
+    def set_status(message)
+      self.status=message
+      session.post('facebook.users.setStatus',:status=>message,:status_includes_verb=>1) do |ret|
+        ret
+      end
+    end
+    
+    ##
+    # Checks to see if the user has enabled the given extended permission
+    def has_permission?(ext_perm) # ext_perm = email, offline_access, status_update, photo_upload, create_listing, create_event, rsvp_event, sms
+      session.post('facebook.users.hasAppPermission',:ext_perm=>ext_perm) == "1"
+    end    
+    
+    ##
+    # Convenience method to send email to the current user
+    def send_email(subject, text=nil, fbml=nil)
+      session.send_email([@id], subject, text, fbml)
+    end
+    
+    ##
+    # Convenience method to set cookie for the current user
+    def set_cookie(name, value, expires=nil, path=nil)
+      session.data.set_cookie(@id, name, value, expires, path)
+    end
+    
+    ##
+    # Convenience method to get cookies for the current user
+    def get_cookies(name=nil)
+      session.data.get_cookies(@id, name)
+    end
+    
+    ##
+    # Returns the user's id as an integer
+    def to_i
+      id
+    end
+    
+    def to_s
+      id.to_s
+    end
+    
+    ##
+    # Two Facebooker::User objects should be considered equal if their Facebook ids are equal
+    def ==(other_user)
+      id == other_user.id
+    end
+    
+    
+    # register a user with Facebook
+    # users should be a hast with at least an :email field
+    # you can optionally provide an :account_id field as well
+        
+    def self.register(users)
+      user_map={}
+      users=users.map do |h|
+        returning h.dup do |d|
+          if email=d.delete(:email)
+            hash = hash_email(email)
+            user_map[hash]=h
+            d[:email_hash]=hash
+          end
+        end
+      end
+      Facebooker::Session.create.post("facebook.connect.registerUsers",:accounts=>users.to_json) do |ret|
+        ret.each do |hash|
+          user_map.delete(hash)
+        end
+        unless user_map.empty?
+          e=Facebooker::Session::UserRegistrationFailed.new
+          e.failed_users = user_map.values
+          raise e
+        end
+        ret
+      end
+    end
+    
+    def self.hash_email(email)
+      email = email.downcase.strip
+      crc=Zlib.crc32(email)
+      md5=Digest::MD5.hexdigest(email)
+      "#{crc}_#{md5}"
+    end
+    
+    def self.cast_to_facebook_id(object)
+      if object.respond_to?(:facebook_id)
+        object.facebook_id
+      else
+        object
+      end
+    end
+    
+    def facebook_id
+      @id
+    end
+    
+    def self.user_fields(fields = [])
+      valid_fields(fields)
+    end
+    
+    def self.standard_fields(fields = [])
+      valid_fields(fields,STANDARD_FIELDS)
+    end
+    
+    private
+    def publish(feed_story_or_action)
+      session.post(Facebooker::Feed::METHODS[feed_story_or_action.class.name.split(/::/).last], feed_story_or_action.to_params) == "1" ? true : false
+    end
+    
+    def self.valid_fields(fields, allowable=FIELDS)
+      allowable.reject{|field_name| !fields.empty? && !fields.include?(field_name)}.join(',')
+    end
+    
+    def collect(fields, allowable=FIELDS)
+      allowable.reject{|field_name| !fields.empty? && !fields.include?(field_name)}.join(',')
+    end
+    
+    def profile_pic_album_id
+      merge_aid(-3, @id)
+    end
+    
+    def merge_aid(aid, uid)
+      (uid << 32) + (aid & 0xFFFFFFFF)
+    end
+    
+  end
+end