podio 0.8.0 → 1.0.0

data/lib/podio/models/contract_event.rb

@@ -0,0 +1,17 @@
+class Podio::ContractEvent < ActivePodio::Base
+  property :type, :string
+  property :created_on, :datetime
+  
+  has_one :created_by, :class => 'ByLine'
+  has_one :created_via, :class => 'Via'
+
+  class << self
+    # @see https://hoist.podio.com/api/apps/apioperations/items/699
+    def find_all_for_contract(contract_id, options = {})
+      list Podio.connection.get { |req|
+        req.url("/contract/#{contract_id}/event/", options)
+      }.body
+    end
+    
+  end
+end

data/lib/podio/models/contract_price.rb

@@ -1,6 +1,6 @@
 class Podio::ContractPrice < ActivePodio::Base
   property :total, :float
-  
+
   has_many :users, :class => 'ContractUser'
 
   def premium_employees
@@ -23,10 +23,6 @@ class Podio::ContractPrice < ActivePodio::Base
     items['emp_network'].present?
   end
 
-  def total_for_emp_network
-    items['emp_network']['sub_total']
-  end
-  
   def items
     if @items.nil?
       @items = {}
@@ -36,11 +32,11 @@ class Podio::ContractPrice < ActivePodio::Base
     end
     @items
   end
-  
+
 end
 
 class Podio::ContractPriceItem < ActivePodio::Base
   property :sub_total, :float
   property :quantity, :integer
   property :already_paid, :integer
-end
+end

data/lib/podio/models/contract_price_v2.rb

@@ -0,0 +1,31 @@
+class Podio::ContractPriceV2 < ActivePodio::Base
+
+  has_one :employee, :class => 'ContractPriceItemV2'
+  has_one :external, :class => 'ContractPriceItemV2'
+
+  def total
+    self.employee.sub_total + self.external.sub_total
+  end
+
+  class << self
+    def calculate(contract_id, attributes)
+      response = Podio.connection.post do |req|
+        req.url "/contract/#{contract_id}/price/v2"
+        req.body = attributes
+      end
+
+      member response.body
+    end
+
+  end
+end
+
+class Podio::ContractPriceItemV2 < ActivePodio::Base
+  property :price, :float # Price per user
+  property :quantity, :integer # Number of users
+
+  def sub_total
+    (self.quantity*self.price).to_f
+  end
+
+end

data/lib/podio/models/contract_user.rb

@@ -0,0 +1,4 @@
+class Podio::ContractUser < Podio::User
+  property :subtotal, :float
+  property :items, :hash
+end

data/lib/podio/models/conversation.rb

@@ -1,6 +1,10 @@
+# @see https://developers.podio.com/doc/conversations
 class Podio::Conversation < ActivePodio::Base
+  include ActivePodio::Updatable
+
   property :conversation_id, :integer
   property :subject, :string
+  property :pinned, :boolean
 
   # When inputting conversation
   property :text, :string
@@ -8,45 +12,86 @@ class Podio::Conversation < ActivePodio::Base
   property :file_ids, :array
   property :embed_id, :integer
   property :embed_file_id, :integer
-  
+
   # When outputting conversation(s)
+  property :link, :string
   property :created_on, :datetime
+  property :excerpt, :string
+  property :last_event_on, :datetime
+  property :starred, :boolean
+  property :unread, :boolean
+  property :type, :string
+  property :push, :hash
+  property :presence, :hash
+
   has_one :embed, :class => 'Embed'
   has_one :embed_file, :class => 'FileAttachment'
   has_one :created_by, :class => 'ByLine'
+  has_one :live, :class => 'Live'
   has_many :files, :class => 'FileAttachment'
   has_many :messages, :class => 'ConversationMessage'
   has_many :participants_full, :class => 'ConversationParticipant'
 
-  
   alias_method :id, :conversation_id
-  alias_method :name, :subject # So tasks can refer to ref.name on all types of references
+
+  # So tasks can refer to ref.name on all types of references
+  def name
+    self.subject || self.excerpt
+  end
 
   def save
     self[:file_ids] ||= []
-    response = Conversation.create(self.attributes)
-    self.conversation_id = response['conversation_id']
+    model = self.class.create(self.attributes)
+    self.attributes = model.attributes
   end
-  
-  handle_api_errors_for :save # Call must be made after the methods to handle have been defined
-  
+
   class << self
+    # @see https://developers.podio.com/doc/conversations/get-conversations-34822801
+    def find_all(options={})
+      list Podio.connection.get { |req|
+        req.url("/conversation/", options)
+      }.body
+    end
+
+    # @see https://developers.podio.com/doc/conversations/get-flagged-conversations-35466860
+    def find_all_by_flag(flag, options={})
+      list Podio.connection.get { |req|
+        req.url("/conversation/#{flag}/", options)
+      }.body
+    end
+
+    # @see https://developers.podio.com/doc/conversations/search-conversations-36885550
+    def search(options={})
+      list Podio.connection.get { |req|
+        req.url "/conversation/search/", options
+      }.body
+    end
+
+    # @see https://developers.podio.com/doc/conversations/get-conversation-22369
     def find(conversation_id)
       member Podio.connection.get("/conversation/#{conversation_id}").body
     end
 
+    # @see https://developers.podio.com/doc/conversations/get-conversations-on-object-22443
     def find_all_for_reference(ref_type, ref_id)
       list Podio.connection.get("/conversation/#{ref_type}/#{ref_id}/").body
     end
 
+    # @see https://developers.podio.com/doc/conversations/get-existing-direct-conversation-44969910
+    def find_direct_with_user(user_id)
+      member Podio.connection.get("/conversation/direct/#{user_id}").body
+    end
+
+    # @see https://developers.podio.com/doc/conversations/create-conversation-v2-37301474
     def create(attributes)
       response = Podio.connection.post do |req|
-        req.url '/conversation/'
+        req.url '/conversation/v2/'
         req.body = attributes
       end
-      response.body
+      member response.body
     end
 
+    # @see https://developers.podio.com/doc/conversations/create-conversation-on-object-22442
     def create_for_reference(ref_type, ref_id, attributes)
       response = Podio.connection.post do |req|
         req.url "/conversation/#{ref_type}/#{ref_id}/"
@@ -54,7 +99,8 @@ class Podio::Conversation < ActivePodio::Base
       end
       response.body
     end
-    
+
+    # @see https://developers.podio.com/doc/conversations/reply-to-conversation-22444
     def create_reply(conversation_id, text, file_ids=[], embed_id=nil, embed_file_id=nil)
       response = Podio.connection.post do |req|
         req.url "/conversation/#{conversation_id}/reply"
@@ -62,7 +108,16 @@ class Podio::Conversation < ActivePodio::Base
       end
       response.body['message_id']
     end
-    
+
+    # @see https://developers.podio.com/doc/conversations/add-participants-384261
+    def add_participants(conversation_id, participants)
+      response = Podio.connection.post do |req|
+        req.url "/conversation/#{conversation_id}/participant/"
+        req.body = { :participants => participants }
+      end
+      response.body
+    end
+
     def add_participant(conversation_id, user_id)
       response = Podio.connection.post do |req|
         req.url "/conversation/#{conversation_id}/participant/"
@@ -70,6 +125,52 @@ class Podio::Conversation < ActivePodio::Base
       end
       response.body
     end
-    
+
+    # @see https://developers.podio.com/doc/conversations/mark-all-conversations-as-read-38080233
+    def mark_all_as_read
+      Podio.connection.post("/conversation/read").status
+    end
+
+    # @see https://developers.podio.com/doc/conversations/mark-conversation-as-read-35441525
+    def mark_as_read(conversation_id)
+      response = Podio.connection.post do |req|
+        req.url "/conversation/#{conversation_id}/read"
+      end
+      response.status
+    end
+
+    # @see https://developers.podio.com/doc/conversations/mark-conversation-as-unread-35441542
+    def mark_as_unread(conversation_id)
+      Podio.connection.delete("/conversation/#{conversation_id}/read").status
+    end
+
+    # @see https://developers.podio.com/doc/conversations/star-conversation-35106944
+    def star(conversation_id)
+      response = Podio.connection.post do |req|
+        req.url "/conversation/#{conversation_id}/star"
+      end
+      response.status
+    end
+
+    # @see https://developers.podio.com/doc/conversations/unstar-conversation-35106990
+    def unstar(conversation_id)
+      Podio.connection.delete("/conversation/#{conversation_id}/star").status
+    end
+
+    # @see https://developers.podio.com/doc/conversations/get-flagged-conversation-counts-35467925
+    def unread_count
+      Podio.connection.get("/conversation/unread/count").body['value']
+    end
+
+    # @see https://developers.podio.com/doc/conversations/get-flagged-conversation-counts-35467925
+    def starred_count
+      Podio.connection.get("/conversation/starred/count").body['value']
+    end
+
+    # @see https://developers.podio.com/doc/conversations/leave-conversation-35483748
+    def leave(conversation_id)
+      Podio.connection.post("/conversation/#{conversation_id}/leave")
+    end
+
   end
 end

data/lib/podio/models/conversation_event.rb

@@ -0,0 +1,51 @@
+# @see https://developers.podio.com/doc/conversations
+class Podio::ConversationEvent < ActivePodio::Base
+  property :event_id, :integer
+  property :action, :string # message, participant_add, participant_leave
+  property :created_on, :datetime
+
+  has_one :data, :class_property => :action, :class_map => { :message => 'ConversationMessage', :participant_leave => 'User', :participant_add => 'User', :live_start => 'Live', :live_end => 'Live', :live_accept => 'Live', :live_decline => 'Live', :subject_change => 'User' }
+  has_one :created_by, :class => 'ByLine'
+  has_one :created_via, :class => 'Via'
+
+  alias_method :id, :event_id
+
+  class << self
+    # @see https://developers.podio.com/doc/conversations/get-conversation-events-35440697
+    def find_all(conversation_id, options = {})
+      list Podio.connection.get { |req|
+        req.url("/conversation/#{conversation_id}/event/", options)
+      }.body
+    end
+
+    def add_participants(conversation_id, participants)
+      response = Podio.connection.post do |req|
+        req.url "/conversation/#{conversation_id}/participant/v2/"
+        req.body = { :participants => participants }
+      end
+      list response.body
+    end
+
+    def create_reply(conversation_id, text, file_ids=[], embed_id=nil, embed_file_id=nil)
+      response = Podio.connection.post do |req|
+        req.url "/conversation/#{conversation_id}/reply/v2"
+        req.body = {:text => text, :file_ids => file_ids, :embed_id => embed_id, :embed_file_id => embed_file_id}
+      end
+      member response.body
+    end
+
+    # @see https://developers.podio.com/doc/conversations/get-conversation-event-35628220
+    def find(id)
+      member Podio.connection.get("/conversation/event/#{id}").body
+    end
+
+    def change_subject(conversation_id, subject)
+      response = Podio.connection.put do |req|
+        req.url "/conversation/#{conversation_id}/subject"
+        req.body = { :subject => subject }
+      end
+      
+      member response.body
+    end
+  end
+end

data/lib/podio/models/conversation_message.rb

@@ -1,3 +1,4 @@
+# @see https://developers.podio.com/doc/conversations
 class Podio::ConversationMessage < ActivePodio::Base
   property :message_id, :integer
   property :embed_id, :integer
@@ -9,6 +10,6 @@ class Podio::ConversationMessage < ActivePodio::Base
   has_one :embed_file, :class => 'FileAttachment'
   has_one :created_by, :class => 'ByLine'
   has_many :files, :class => 'FileAttachment'
-  
+
   alias_method :id, :message_id
 end

data/lib/podio/models/conversation_participant.rb

@@ -1,9 +1,10 @@
+# @see https://developers.podio.com/doc/conversations
 class Podio::ConversationParticipant < ActivePodio::Base
   property :created_on, :datetime
-  
+
   has_one :user, :class => 'User'
   has_one :created_by, :class => 'ByLine'
   has_one :created_via, :class => 'Via'
 
   delegate :id, :name, :avatar, :link, :to => :user, :prefix => false
-end
+end

data/lib/podio/models/date_election.rb

@@ -0,0 +1,35 @@
+class Podio::DateElectionVote < ActivePodio::Base
+  property :date_option_id, :integer
+  property :value, :boolean
+
+  has_one :user, :class => 'Contact'
+end
+
+class Podio::DateElectionOption < ActivePodio::Base
+  property :date_option_id, :integer
+  property :start_utc, :datetime
+  property :end_utc, :datetime
+end
+
+class Podio::DateElection < ActivePodio::Base
+  property :date_election_id, :integer
+
+  has_many :votes, :class => 'DateElectionVote'
+  has_many :options, :class => 'DateElectionOption'
+
+  class << self
+    def vote(date_election_id, date_option_id, value)
+      Podio.connection.post do |req|
+        req.url "/date_election/#{date_election_id}/vote"
+        req.body = {:date_option_id => date_option_id.to_i, :value => value}
+      end
+    end
+
+    def choose(date_election_id, date_option_id)
+      Podio.connection.post do |req|
+        req.url "/date_election/#{date_election_id}/choose"
+        req.body = {:date_option_id => date_option_id.to_i}
+      end
+    end
+  end
+end

data/lib/podio/models/email_contact.rb

@@ -0,0 +1,46 @@
+# @see https://developers.podio.com/doc/email
+class Podio::EmailContact < ActivePodio::Base
+
+  property :name, :string
+  property :mail, :string
+
+  class << self
+    # @see https://developers.podio.com/doc/email/get-global-contact-13716154
+    def get_global(name)
+      member Podio.connection.get("/email/contact/#{name}").body
+    end
+
+    # @see https://developers.podio.com/doc/email/get-email-contact-for-reference-13716555
+    def get_ref(name, ref_type, ref_id)
+      member Podio.connection.get("/email/contact/#{name}/#{ref_type}/#{ref_id}").body
+    end
+
+    # @see https://developers.podio.com/doc/email/get-global-email-contact-as-vcard-13624848
+    def get_global_as_vcard(name)
+      Podio.connection.get("/email/contact/#{name}/vcard").body
+    end
+
+    # @see https://developers.podio.com/doc/email/get-email-contact-for-reference-as-vcard-13628255
+    def get_ref_as_vcard(name, ref_type, ref_id)
+      Podio.connection.get("/email/contact/#{name}/#{ref_type}/#{ref_id}/vcard").body
+    end
+
+    # @see https://developers.podio.com/doc/email/export-global-email-contact-to-linked-account-13629508
+    def export_global(name, linked_acc_id)
+      Podio.connection.post { |req|
+        req.url "/email/contact/#{name}/export"
+        req.body = { :linked_account_id => linked_acc_id }
+      }.body
+    end
+
+    # @see https://developers.podio.com/doc/email/export-email-contact-for-reference-to-linked-account-13628926
+    def export_ref(name, ref_type, ref_id, linked_acc_id)
+      Podio.connection.post { |req|
+        req.url "/email/contact/#{name}/#{ref_type}/#{ref_id}/export"
+        req.body = { :linked_account_id => linked_acc_id }
+      }.body
+    end
+
+  end
+
+end

data/lib/podio/models/email_subscription_setting.rb

@@ -1,8 +1,8 @@
+# @see https://developers.podio.com/doc/email
 class Podio::EmailSubscriptionSetting < ActivePodio::Base
   include ActivePodio::Updatable
 
   property :digest, :boolean
-  property :bulletin, :boolean
   property :reference, :boolean
   property :message, :boolean
   property :reminder, :boolean
@@ -21,12 +21,14 @@ class Podio::EmailSubscriptionSetting < ActivePodio::Base
   end
 
   class << self
+    # @see https://developers.podio.com/doc/email/get-groups-333977
     def get_groups()
       member Podio.connection.get { |req|
         req.url("/email/group/", {})
       }.body
     end
 
+    # @see https://developers.podio.com/doc/email/update-groups-333981
     def update_groups(options)
       Podio.connection.put { |req|
         req.url "/email/group/"
@@ -34,32 +36,11 @@ class Podio::EmailSubscriptionSetting < ActivePodio::Base
       }.body
     end
 
+    # @see https://developers.podio.com/doc/email/unsubscribe-from-all-304917
     def unsubscribe(username)
       Podio.connection.post("/email/unsubscribe/#{username}").status
     end
 
-    def get_global_email_as_vcard(name)
-      Podio.connection.get("/email/contact/#{name}/vcard").body
-    end
-
-    def get_ref_email_as_vcard(name, ref_type, ref_id)
-      Podio.connection.get("/email/contact/#{name}/#{ref_type}/#{ref_id}/vcard").body
-    end
-
-    def export_global_contact_to_linked_acc(name, linked_acc_id)
-      Podio.connection.post { |req|
-        req.url "/email/contact/#{name}/export"
-        req.body = { :linked_account_id => linked_acc_id }
-      }.body
-    end
-
-    def export_ref_contact_to_linked_acc(name, ref_type, ref_id, linked_acc_id)
-      Podio.connection.post { |req|
-        req.url "/email/contact/#{name}/#{ref_type}/#{ref_id}/export"
-        req.body = { :linked_account_id => linked_acc_id }
-      }.body
-    end
-
   end
 
 end