podio 0.8.0 → 1.0.0

data/lib/podio/models/promotion.rb

@@ -0,0 +1,91 @@
+class Podio::Promotion < ActivePodio::Base
+  property :promotion_id, :integer
+  property :name, :string
+  property :status, :string
+  property :display_type, :string
+  property :display_data, :hash
+  property :context, :string
+  property :contextual, :boolean
+  property :priority, :integer
+  property :max_views, :integer
+  property :max_uses, :integer
+  property :max_duration, :integer
+  property :sleep, :integer
+  property :condition_set_ids, :array
+
+  alias_method :id, :promotion_id
+
+  class << self
+    def find_all(options={})
+      list Podio.connection.get { |req|
+        req.url("/promotion/", options)
+      }.body
+    end
+
+    def find(promotion_id)
+      member Podio.connection.get("/promotion/#{promotion_id}").body
+    end
+
+    def create(attributes)
+      member Podio.connection.post { |req|
+        req.url("/promotion/")
+        req.body = attributes
+      }.body
+    end
+
+    def update(promotion_id, attributes)
+      member Podio.connection.put { |req|
+        req.url("/promotion/#{promotion_id}")
+        req.body = attributes
+      }.body
+    end
+
+    def enable(promotion_id)
+      member Podio.connection.post("/promotion/#{promotion_id}/enable").body
+    end
+
+    def disable(promotion_id)
+      member Podio.connection.post("/promotion/#{promotion_id}/disable").body
+    end
+
+    def delete(promotion_id)
+      Podio.connection.delete("/promotion/#{promotion_id}")
+    end
+
+    def stats(promotion_id)
+      Podio.connection.get("/promotion/#{promotion_id}/stats").body
+    end
+
+    def assign(promotion_id, user_id, body)
+      Podio.connection.post { |req|
+        req.url("/promotion/#{promotion_id}/assign/#{user_id}")
+        req.body = body
+      }
+    end
+
+    def find_for_context(context_name, options = {})
+      result = Podio.connection.get("/promotion/#{context_name}", options)
+
+      if result.body.present?
+        member(result.body)
+      else
+        nil
+      end
+    end
+
+    def end(promotion_id, body = nil)
+      Podio.connection.post { |req|
+        req.url "/promotion/#{promotion_id}/end"
+        req.body = body
+      }
+    end
+
+    def click(promotion_id, body = nil)
+      Podio.connection.post { |req|
+        req.url "/promotion/#{promotion_id}/click"
+        req.body = body
+      }
+    end
+  end
+
+end

data/lib/podio/models/rating.rb

@@ -1,12 +1,14 @@
+# @see https://developers.podio.com/doc/ratings
 class Podio::Rating < ActivePodio::Base
 
   property :rating_id, :integer
   property :type, :string
   property :value, :string
-  
+
   alias_method :id, :rating_id
-  
+
   class << self
+    # @see https://developers.podio.com/doc/ratings/add-rating-22377
     def create(ref_type, ref_id, rating_type, value)
       response = Podio.connection.post do |req|
         req.url "/rating/#{ref_type}/#{ref_id}/#{rating_type}"
@@ -16,25 +18,41 @@ class Podio::Rating < ActivePodio::Base
       response.body['rating_id']
     end
 
+    # @see https://developers.podio.com/doc/ratings/get-all-ratings-22376
     def find_all(ref_type, ref_id)
       collection Podio.connection.get("/rating/#{ref_type}/#{ref_id}").body
     end
-    
+
+    # @see https://developers.podio.com/doc/ratings/get-rating-22407
     def find(ref_type, ref_id, rating_type, user_id)
       Podio.connection.get("/rating/#{ref_type}/#{ref_id}/#{rating_type}/#{user_id}").body['value']
     end
 
+    # @see https://developers.podio.com/doc/ratings/get-rating-own-84128
     def find_own(ref_type, ref_id, rating_type)
       Podio.connection.get("/rating/#{ref_type}/#{ref_id}/#{rating_type}/self").body['value']
     end
 
+    # @see https://developers.podio.com/doc/ratings/get-ratings-22375
     def find_all_by_type(ref_type, ref_id, rating_type)
       collection Podio.connection.get("/rating/#{ref_type}/#{ref_id}/#{rating_type}").body
     end
 
+    # @see https://developers.podio.com/doc/ratings/remove-rating-22342
     def delete(ref_type, ref_id, rating_type)
       Podio.connection.delete("/rating/#{ref_type}/#{ref_id}/#{rating_type}").body
     end
+
+    # @see https://developers.podio.com/doc/comments/get-who-liked-a-comment-29007011
+    def liked_by(ref_type, ref_id)
+      Podio.connection.get("/rating/#{ref_type}/#{ref_id}/liked_by/").body.map{|values| Podio::Contact.new(values)}
+    end
+
+    # @see https://developers.podio.com/doc/ratings/get-like-count-32161225
+    def like_count(ref_type, ref_id)
+      Podio.connection.get("/rating/#{ref_type}/#{ref_id}/like_count").body["like_count"]
+    end
+
   end
-  
-end
+
+end

data/lib/podio/models/recurrence.rb

@@ -1,3 +1,4 @@
+# @see https://developers.podio.com/doc/recurrence
 class Podio::Recurrence < ActivePodio::Base
   property :recurrence_id, :integer
   property :name, :string
@@ -7,12 +8,14 @@ class Podio::Recurrence < ActivePodio::Base
 
   alias_method :id, :recurrence_id
   delegate_to_hash :config, :days, :repeat_on, :setter => true
-  
+
   class << self
+    # @see https://developers.podio.com/doc/recurrence/delete-recurrence-3349970
     def delete(ref_type, ref_id)
       Podio.connection.delete("/recurrence/#{ref_type}/#{ref_id}").body
     end
-    
+
+    # @see https://developers.podio.com/doc/recurrence/create-or-update-recurrence-3349957
     def update(ref_type, ref_id, attributes)
       response = Podio.connection.put do |req|
         req.url "/recurrence/#{ref_type}/#{ref_id}"
@@ -21,5 +24,5 @@ class Podio::Recurrence < ActivePodio::Base
       response.status
     end
   end
-  
+
 end

data/lib/podio/models/reference.rb

@@ -1,7 +1,9 @@
+# @see https://developers.podio.com/doc/reference
 class Podio::Reference < ActivePodio::Base
 
   property :type, :string
   property :id, :integer
+  property :type_name, :string
   property :title, :string
   property :link, :string
   property :data, :hash
@@ -11,13 +13,15 @@ class Podio::Reference < ActivePodio::Base
   has_one :created_via, :class => 'Via'
 
   class << self
+    # @see https://developers.podio.com/doc/reference/get-reference-10661022
     def find(ref_type, ref_id, options = {})
       member Podio.connection.get { |req|
         req.url("/reference/#{ref_type}/#{ref_id}", options)
       }.body
     end
 
-    def search(target, query, limit)
+    # @see https://developers.podio.com/doc/reference/search-references-13312595
+    def search(target, query, limit, target_params = nil)
       response = Podio.connection.post do |req|
         req.url "/reference/search"
         req.body = {
@@ -25,9 +29,21 @@ class Podio::Reference < ActivePodio::Base
           :text => query,
           :limit => limit
         }
+        req.body[:target_params] = target_params if target_params.present?
       end
       response.body
     end
 
+    # @see https://developers.podio.com/doc/reference/get-users-with-access-to-object-16681010
+    def find_users_with_access(ref_type, ref_id, options = {})
+      self.klass_from_string('Contact').list Podio.connection.get { |req|
+        req.url("/reference/#{ref_type}/#{ref_id}/accessible_by/", options)
+      }.body
+    end
+
+    # @see https://developers.podio.com/doc/reference/count-user-profiles-with-access-to-object-19190550
+    def count_users_with_access(ref_type, ref_id)
+      Podio.connection.get("/reference/#{ref_type}/#{ref_id}/accessible_by/count").body['count']
+    end
   end
 end

data/lib/podio/models/reminder.rb

@@ -1,18 +1,22 @@
+# @see https://developers.podio.com/doc/reminders
 class Podio::Reminder < ActivePodio::Base
   property :reminder_id, :integer
   property :remind_delta, :integer
 
   alias_method :id, :reminder_id
-  
+
   class << self
+    # @see https://developers.podio.com/doc/reminders/delete-reminder-3315117
     def delete(ref_type, ref_id)
       Podio.connection.delete("/reminder/#{ref_type}/#{ref_id}").body
     end
-    
+
+    # @see https://developers.podio.com/doc/reminders/snooze-reminder-3321049
     def snooze(ref_type, ref_id)
       Podio.connection.post("/reminder/#{ref_type}/#{ref_id}/snooze").body
     end
 
+    # @see https://developers.podio.com/doc/reminders/create-or-update-reminder-3315055
     def create(ref_type, ref_id, attributes)
       response = Podio.connection.post do |req|
         req.url "/reminder/#{ref_type}/#{ref_id}"
@@ -21,6 +25,7 @@ class Podio::Reminder < ActivePodio::Base
       response.status
     end
 
+    # @see https://developers.podio.com/doc/reminders/create-or-update-reminder-3315055
     def update(ref_type, ref_id, attributes)
       response = Podio.connection.put do |req|
         req.url "/reminder/#{ref_type}/#{ref_id}"
@@ -29,5 +34,5 @@ class Podio::Reminder < ActivePodio::Base
       response.status
     end
   end
-  
+
 end

data/lib/podio/models/search.rb

@@ -1,3 +1,4 @@
+# @see https://developers.podio.com/doc/search
 class Podio::Search < ActivePodio::Base
   property :type, :string
   property :id, :integer
@@ -13,15 +14,18 @@ class Podio::Search < ActivePodio::Base
   has_one :space, :class => 'Space'
 
   class << self
+    # @see https://developers.podio.com/doc/search/search-in-organization-22487
     def in_org(org_id, words)
+      attributes[:query] = words
       response = Podio.connection.post do |req|
         req.url "/search/org/#{org_id}/"
-        req.body = words
+        req.body = attributes
       end
 
       list response.body
     end
 
+    # @see https://developers.podio.com/doc/search/search-globally-22488
     def globally(words, attributes={})
       attributes[:query] = words
       response = Podio.connection.post do |req|
@@ -32,6 +36,7 @@ class Podio::Search < ActivePodio::Base
       list response.body
     end
 
+    # @see https://developers.podio.com/doc/search/search-in-space-22479
     def in_space(space_id, words, attributes={})
       attributes[:query] = words
       response = Podio.connection.post do |req|
@@ -42,6 +47,7 @@ class Podio::Search < ActivePodio::Base
       list response.body
     end
 
+    # @see https://developers.podio.com/doc/search/search-in-app-4234651
     def in_app(app_id, words, attributes={})
       attributes[:query] = words
       response = Podio.connection.post do |req|

data/lib/podio/models/space.rb

@@ -1,13 +1,16 @@
+# @see https://developers.podio.com/doc/spaces
 class Podio::Space < ActivePodio::Base
   include ActivePodio::Updatable
 
   property :space_id, :integer
   property :name, :string
+  property :description, :string
   property :url, :string
   property :url_label, :string
   property :org_id, :integer
   property :contact_count, :integer
-  property :members, :integer
+  property :member_count, :integer
+  property :app_count, :integer
   property :role, :string
   property :rights, :array
   property :post_on_new_app, :boolean
@@ -19,19 +22,32 @@ class Podio::Space < ActivePodio::Base
   property :premium, :boolean
   property :last_activity_on, :datetime
   property :created_on, :datetime
+  property :is_overdue, :boolean
+  property :push, :hash
 
   has_one :created_by, :class => 'ByLine'
+  has_one :org, :class => 'Organization'
 
   alias_method :id, :space_id
 
+  # @see https://developers.podio.com/doc/spaces/create-space-22390
   def create
     response = Space.create(:org_id => org_id, :name => name, :privacy => self.privacy, :auto_join => self.auto_join)
     self.url = response['url']
     self.space_id = response['space_id']
   end
 
+  # @see https://developers.podio.com/doc/spaces/update-space-22391
   def update
-    self.class.update(self.space_id, :name => self.name, :post_on_new_app => self.post_on_new_app, :post_on_new_member => self.post_on_new_member, :url_label => self.url_label, :privacy => self.privacy, :auto_join => self.auto_join)
+    self.class.update(space_id,
+      :name               => name,
+      :post_on_new_app    => post_on_new_app,
+      :post_on_new_member => post_on_new_member,
+      :url_label          => url_label,
+      :privacy            => privacy,
+      :auto_join          => auto_join,
+      :description        => description
+    )
   end
 
   def delete
@@ -39,6 +55,7 @@ class Podio::Space < ActivePodio::Base
   end
 
   class << self
+    # @see https://developers.podio.com/doc/spaces/create-space-22390
     def create(attributes)
       response = Podio.connection.post do |req|
         req.url '/space/'
@@ -48,6 +65,7 @@ class Podio::Space < ActivePodio::Base
       response.body
     end
 
+    # @see https://developers.podio.com/doc/spaces/update-space-22391
     def update(space_id, attributes)
       Podio.connection.put("/space/#{space_id}", attributes).status
     end
@@ -56,18 +74,30 @@ class Podio::Space < ActivePodio::Base
       Podio.connection.delete("/space/#{id}").status
     end
 
+    # @see https://developers.podio.com/doc/spaces/get-space-22389
     def find(id)
       member Podio.connection.get("/space/#{id}").body
     end
 
+    # @see https://developers.podio.com/doc/space-members/join-space-1927286
     def join(space_id)
       Podio.connection.post("/space/#{space_id}/join").body
     end
 
+    # @see https://developers.podio.com/doc/organizations/end-organization-membership-19410457
+    def leave(space_id)
+      Podio.connection.post("/space/#{space_id}/leave").status
+    end
+
+    # @see https://developers.podio.com/doc/spaces/get-space-by-url-22481
     def find_by_url(url)
       member Podio.connection.get("/space/url?url=#{ERB::Util.url_encode(url)}").body
     end
 
+    def find_by_url_slug(org_slug, space_slug)
+      member Podio.connection.get("/space/url", :org_slug => org_slug, :space_slug => space_slug).body
+    end
+
     def find_all_for_org(org_id)
       list Podio.connection.get("/org/#{org_id}/space/").body
     end
@@ -76,6 +106,7 @@ class Podio::Space < ActivePodio::Base
       list Podio.connection.get("/org/#{org_id}/all_spaces/", options).body
     end
 
+    # @see https://developers.podio.com/doc/spaces/get-available-spaces-1911961
     def find_open_for_org(org_id)
       list Podio.connection.get("/space/org/#{org_id}/available/").body
     end
@@ -87,6 +118,14 @@ class Podio::Space < ActivePodio::Base
       }.body
     end
 
+    def get_overdue_info(space_id)
+      Podio.connection.get("/space/#{space_id}/overdue").body
+    end
+    
+    def get_count(org_id)
+      Podio.connection.get("/space/org/#{org_id}").body['count']
+    end
+
   end
 end
 

data/lib/podio/models/space_contact.rb

@@ -1,3 +1,4 @@
+# @see https://developers.podio.com/doc/contacts
 class Podio::SpaceContact < Podio::Profile
   include ActivePodio::Updatable
 
@@ -18,6 +19,4 @@ class Podio::SpaceContact < Podio::Profile
   def destroy
     self.class.delete_contact(self.profile_id)
   end
-
-  handle_api_errors_for :create, :update # Call must be made after the methods to handle have been defined
 end

data/lib/podio/models/space_invitation.rb

@@ -16,6 +16,7 @@ class Podio::SpaceInvitation < ActivePodio::Base
   property :external_contacts, :hash
 
   has_one :user, :class => 'User'
+  has_one :inviter, :class => 'Contact'
 
   def save
     self.class.create(self.space_id, self.role, self.attributes.except(:contacts))
@@ -29,8 +30,6 @@ class Podio::SpaceInvitation < ActivePodio::Base
     self.class.accept(invite_code)
   end
 
-  handle_api_errors_for :save, :save_member, :accept # Call must be made after the methods to handle have been defined
-
   class << self
     def create(space_id, role, attributes={})
       response = Podio.connection.post do |req|
@@ -69,15 +68,15 @@ class Podio::SpaceInvitation < ActivePodio::Base
     end
 
     def find_member(invite_code)
-      member Podio.connection.get("/space/membership?invite_code=#{invite_code}").body
+      member Podio.client.trusted_connection.get("/space/membership?invite_code=#{invite_code}").body
     end
 
     def decline_member(invite_code)
-      Podio.connection.delete("/space/membership?invite_code=#{invite_code}").status
+      Podio.client.trusted_connection.delete("/space/membership?invite_code=#{invite_code}").status
     end
 
     def claim_member(invite_code)
-      Podio.connection.post("/space/membership/claim?invite_code=#{invite_code}").status
+      Podio.connection.post("/space/membership/claim?invite_code=#{invite_code}").body
     end
   end
 end