podio 0.8.0 → 1.0.0

data/lib/podio/models/invoice.rb

@@ -0,0 +1,30 @@
+class Podio::Invoice < ActivePodio::Base
+  property :invoice_id, :string
+  property :number, :string
+  property :date, :datetime
+  property :due_date, :datetime
+  property :amount, :float
+  property :amount_due, :float
+  property :amount_paid, :float
+  property :status, :string
+
+  alias_method :id, :invoice_id
+
+  class << self
+    def find(invoice_id)
+      member Podio.connection.get("/invoice/#{invoice_id}").body
+    end
+
+    def get_as_pdf(invoice_id)
+      Podio.client.connection.get("/invoice/#{invoice_id}/pdf").body
+    end
+
+    def find_by_contract(contract_id)
+      list Podio.connection.get("/invoice/contract/#{contract_id}/").body
+    end
+
+    def pay(invoice_id)
+      Podio.connection.post("/invoice/#{invoice_id}/pay").status
+    end
+  end
+end

data/lib/podio/models/item.rb

@@ -1,16 +1,22 @@
+# @see https://developers.podio.com/doc/items
 class Podio::Item < ActivePodio::Base
   include ActivePodio::Updatable
 
   # Included Get Item basic
   property :item_id, :integer
+  property :revision, :integer
   property :app, :hash
+  property :app_item_id, :integer
+  property :app_item_id_formatted, :string
   property :external_id, :string
   property :title, :string
   property :fields, :array
   property :rights, :array
+  property :created_on, :datetime
 
-  has_one :initial_revision, :class => 'ItemRevision'
-  has_one :current_revision, :class => 'ItemRevision'
+  has_one :created_by, :class => 'ByLine'
+  has_one :created_via, :class => 'Via'
+  has_one :date_election, :class => 'DateElection'
 
   # Also included in the full Get item
   property :ratings, :hash
@@ -20,6 +26,7 @@ class Podio::Item < ActivePodio::Base
   property :refs, :array
   property :tags, :array
   property :subscribed, :boolean
+  property :pinned, :boolean
   property :user_ratings, :hash
   property :link, :string
   property :invite, :hash
@@ -27,10 +34,16 @@ class Podio::Item < ActivePodio::Base
   property :linked_account_id, :integer
   property :ref, :hash  # linked items
   property :priority, :float
+  property :excerpt, :string
+  property :is_liked, :boolean
+  property :like_count, :integer
+  property :push, :hash
+  property :presence, :hash
 
   # Get items
   property :comment_count, :integer
   property :task_count, :integer
+  property :subscribed_count, :integer
 
   has_many :revisions, :class => 'ItemRevision'
   has_many :files, :class => 'FileAttachment'
@@ -39,6 +52,7 @@ class Podio::Item < ActivePodio::Base
   has_one :reminder, :class => 'Reminder'
   has_one :recurrence, :class => 'Recurrence'
   has_one :linked_account_data, :class => 'LinkedAccountData'
+  has_one :application, :class => 'Application', :property => :app
 
   # For inserting/updating
   property :file_ids, :array
@@ -46,20 +60,23 @@ class Podio::Item < ActivePodio::Base
   alias_method :id, :item_id
   delegate_to_hash :app, :app_id, :app_name, :item_name
 
+  # @see https://developers.podio.com/doc/items/add-new-item-22362
   def create
-    self.item_id = self.class.create(self.app_id, prepare_item_values(self))
+    model = self.class.create(self.app_id, prepare_item_values(self))
+    self.attributes = model.attributes
+    self
   end
 
+  # @see https://developers.podio.com/doc/items/delete-item-22364
   def destroy
     self.class.delete(self.id)
   end
 
+  # @see https://developers.podio.com/doc/items/update-item-22363
   def update
     self.class.update(self.id, prepare_item_values(self))
   end
 
-  handle_api_errors_for :create, :update
-
   protected
       def prepare_item_values(item)
         fields = item.fields.collect { |field| field.values.nil? ? nil : { :external_id => field.external_id, :values => field.values } }.compact
@@ -70,16 +87,20 @@ class Podio::Item < ActivePodio::Base
       end
 
   class << self
+    # @see https://developers.podio.com/doc/items/get-item-22360
     def find(id)
       member Podio.connection.get("/item/#{id}").body
     end
 
-    def find_basic(id)
-      member Podio.connection.get("/item/#{id}/basic").body
+    def find_by_app_item_id(app_id, app_item_id)
+      member Podio.connection.get("/app/#{app_id}/item/#{app_item_id}").body
     end
 
-    def find_basic_hash(id)
-      Podio.connection.get("/item/#{id}/basic").body
+    # @see https://developers.podio.com/doc/items/get-item-basic-61768
+    def find_basic(id, options={})
+      member Podio.connection.get { |req|
+        req.url("/item/#{id}/basic", options)
+      }.body
     end
 
     def find_basic_by_field(item_id, field_id)
@@ -90,16 +111,22 @@ class Podio::Item < ActivePodio::Base
       Podio.connection.get("/item/#{item_id}/reference/#{field_id}/preview").body
     end
 
+    def find_by_external_id(app_id, external_id)
+      member Podio.connection.get("/item/app/#{app_id}/external_id/#{external_id}").body
+    end
+
     def find_all_by_external_id(app_id, external_id)
       collection Podio.connection.get("/item/app/#{app_id}/v2/?external_id=#{external_id}").body
     end
 
+    # @see https://developers.podio.com/doc/items/get-items-27803
     def find_all(app_id, options={})
       collection Podio.connection.get { |req|
         req.url("/item/app/#{app_id}/", options)
       }.body
     end
 
+    # @see https://developers.podio.com/doc/items/filter-items-by-view-4540284
     def find_by_filter_id(app_id, filter_id, attributes)
       collection Podio.connection.post { |req|
         req.url "/item/app/#{app_id}/filter/#{filter_id}/"
@@ -107,6 +134,7 @@ class Podio::Item < ActivePodio::Base
       }.body
     end
 
+    # @see https://developers.podio.com/doc/items/filter-items-4496747
     def find_by_filter_values(app_id, filter_values, attributes={})
       attributes[:filters] = filter_values
       collection Podio.connection.post { |req|
@@ -115,6 +143,7 @@ class Podio::Item < ActivePodio::Base
       }.body
     end
 
+    # @see https://developers.podio.com/doc/items/get-app-values-22455
     def find_app_values(app_id)
       response = Podio.connection.get { |req|
         req.url("/item/app/#{app_id}/values")
@@ -122,12 +151,22 @@ class Podio::Item < ActivePodio::Base
       response.body
     end
 
+    # @see https://developers.podio.com/doc/items/get-item-references-22439
+    def find_references(item_id)
+      response = Podio.connection.get { |req|
+        req.url("/item/#{item_id}/reference/")
+      }
+      response.body
+    end
+
+    # @see https://developers.podio.com/doc/items/get-references-to-item-by-field-7403920
     def find_references_by_field(item_id, field_id, options = {})
       list Podio.connection.get { |req|
         req.url("/item/#{item_id}/reference/field/#{field_id}", options)
       }.body
     end
 
+    # @see https://developers.podio.com/doc/items/calculate-67633
     def calculate(app_id, config)
       response = Podio.connection.post do |req|
         req.url "/item/app/#{app_id}/calculate"
@@ -143,6 +182,7 @@ class Podio::Item < ActivePodio::Base
       }.body
     end
 
+    # @see https://developers.podio.com/doc/items/get-items-as-xlsx-63233
     def xlsx(app_id, options={})
       response = Podio.connection.get { |req|
         req.url("/item/app/#{app_id}/xlsx/", options)
@@ -150,6 +190,7 @@ class Podio::Item < ActivePodio::Base
       response.body
     end
 
+    # @see https://developers.podio.com/doc/items/export-items-4235696
     def export(app_id, exporter, options={})
       response = Podio.connection.post { |req|
         req.url "/item/app/#{app_id}/export/#{exporter}"
@@ -157,37 +198,62 @@ class Podio::Item < ActivePodio::Base
       }.body
     end
 
+    # @see https://developers.podio.com/doc/items/find-items-by-field-and-title-22485
     def search_field(field_id, options={})
       list Podio.connection.get { |req|
         req.url("/item/field/#{field_id}/find", options)
       }.body
     end
 
-    def create(app_id, attributes)
+    # @see https://developers.podio.com/doc/items/add-new-item-22362
+    def create(app_id, attributes, options={})
       response = Podio.connection.post do |req|
-        req.url "/item/app/#{app_id}/"
+        req.url("/item/app/#{app_id}/", options)
         req.body = attributes
       end
 
-      response.body['item_id']
+      member response.body
     end
 
-    def update(id, attributes)
+    # @see https://developers.podio.com/doc/items/update-item-22363
+    def update(id, attributes, options={})
       response = Podio.connection.put do |req|
-        req.url "/item/#{id}"
+        req.url("/item/#{id}", options)
         req.body = attributes
       end
       response.status
     end
 
+    # @see https://developers.podio.com/doc/items/bulk-delete-items-19406111
+    def bulk_delete(app_id, attributes)
+      response = Podio.connection.post do |req|
+        req.url("/item/app/#{app_id}/delete")
+        req.body = attributes
+      end
+
+      response.body
+    end
+
+    # @see https://developers.podio.com/doc/items/delete-item-22364
     def delete(id)
       Podio.connection.delete("/item/#{id}").body
     end
 
+    # @see https://developers.podio.com/doc/items/delete-item-reference-7302326
     def delete_ref(id)
       Podio.connection.delete("/item/#{id}/ref").body
     end
 
+    # @see https://developers.podio.com/doc/items/clone-item-37722742
+    def clone(item_id, options={})
+      response = Podio.connection.post do |req|
+        req.url("/item/#{item_id}/clone", options)
+      end
+
+      response.body['item_id']
+    end
+
+    # @see https://developers.podio.com/doc/items/set-participation-7156154
     def set_participation(id, status)
       response = Podio.connection.put do |req|
         req.url "/item/#{id}/participation"
@@ -209,6 +275,7 @@ class Podio::Item < ActivePodio::Base
       member response.body
     end
 
+    # @see https://developers.podio.com/doc/items/get-meeting-url-14763260
     def find_meeting_url(id)
       response = Podio.connection.get { |req|
         req.url("/item/#{id}/meeting/url")

data/lib/podio/models/item_diff.rb

@@ -1,20 +1,24 @@
+# @see https://developers.podio.com/doc/items
 class Podio::ItemDiff < ActivePodio::Base
   property :field_id, :integer
   property :type, :string
-  property :external_id, :integer
+  property :external_id, :string
   property :label, :string
+  property :config, :hash
   property :from, :array
   property :to, :array
-  
+
   alias_method :id, :field_id
-  
+
   class << self
+    # @see https://developers.podio.com/doc/items/get-item-revision-difference-22374
     def find_by_item_and_revisions(item_id, revision_from_id, revision_to_id)
       list Podio.connection.get("/item/#{item_id}/revision/#{revision_from_id}/#{revision_to_id}").body
     end
-    
+
+    # @see https://developers.podio.com/doc/items/revert-item-revision-953195
     def revert(item_id, revision_id)
       Podio.connection.delete("/item/#{item_id}/revision/#{revision_id}").body
     end
   end
-end
+end

data/lib/podio/models/item_field.rb

@@ -1,3 +1,4 @@
+# @see https://developers.podio.com/doc/items
 class Podio::ItemField < ActivePodio::Base
   property :field_id, :integer
   property :type, :string
@@ -9,16 +10,24 @@ class Podio::ItemField < ActivePodio::Base
   alias_method :id, :field_id
 
   class << self
-    def update(item_id, field_id, values)
+    # @see https://developers.podio.com/doc/items/update-item-field-values-22367
+    def update(item_id, field_id, values, options = {})
       response = Podio.connection.put do |req|
-        req.url "/item/#{item_id}/value/#{field_id}"
+        req.url("/item/#{item_id}/value/#{field_id}", options)
         req.body = values
       end
       response.body
     end
 
+    # @see https://developers.podio.com/doc/calendar/get-item-field-calendar-as-ical-10195681
     def ical_entry(item_id, field_id)
       Podio.connection.get("/calendar/item/#{item_id}/field/#{field_id}/ics/").body
     end
+
+    # @see https://developers.podio.com/doc/items/get-field-ranges-24242866
+    def get_field_ranges(field_id)
+      Podio.connection.get("/item/field/#{field_id}/range").body
+    end
+
   end
 end

data/lib/podio/models/item_revision.rb

@@ -1,3 +1,4 @@
+# @see https://developers.podio.com/doc/items
 class Podio::ItemRevision < ActivePodio::Base
   property :revision, :integer
   property :app_revision, :integer
@@ -5,14 +6,16 @@ class Podio::ItemRevision < ActivePodio::Base
 
   has_one :created_by, :class => 'ByLine'
   has_one :created_via, :class => 'Via'
-  
+
   class << self
+    # @see https://developers.podio.com/doc/items/get-item-revision-22373
     def find(item_id, revision_id)
       member Podio.connection.get("/item/#{item_id}/revision/#{revision_id}").body
     end
 
+    # @see https://developers.podio.com/doc/items/get-item-revisions-22372
     def find_all_by_item_id(item_id)
       list Podio.connection.get("/item/#{item_id}/revision/").body
     end
   end
-end
+end

data/lib/podio/models/linked_account.rb

@@ -1,5 +1,6 @@
 class Podio::LinkedAccount < ActivePodio::Base
   property :linked_account_id, :integer
+  property :status, :string
   property :label, :string
   property :provider, :string
   property :provider_humanized_name, :string

data/lib/podio/models/live.rb

@@ -0,0 +1,61 @@
+class Podio::Live < ActivePodio::Base
+  property :status, :string
+  property :presence, :hash
+  property :provider, :string
+  property :push, :hash
+  property :live_id, :integer
+  property :settings, :hash
+  property :ref, :hash
+
+  class << self
+
+    # @see https://hoist.podio.com/api/item/45673217
+    def create(ref_type, ref_id, attributes)
+      response = Podio.connection.post do |req|
+        req.url "/live/#{ref_type}/#{ref_id}"
+        req.body = attributes
+      end
+
+      member response.body
+    end
+
+    def update(id, attributes)
+      response = Podio.connection.put do |req|
+        req.url "/live/#{id}/settings"
+        req.body = attributes
+      end
+      response.status
+    end
+
+    def delete(id)
+      Podio.connection.delete("/live/#{id}").body
+    end
+
+    def accept(id)
+      Podio.connection.post("/live/#{id}/accept").status
+    end
+
+    def decline(id)
+      Podio.connection.post("/live/#{id}/decline").status
+    end
+
+    def authorize(attributes)
+      response = Podio.connection.post do |req|
+        req.url "/live/omega/authorize"
+        req.body = attributes
+      end
+
+      response.body
+    end
+
+    def authorize_all
+      Podio.connection.post("/live/omega/authorize/all").body
+    end
+
+    def get_servers
+      Podio.connection.get("/live/servers").body
+    end
+
+  end
+
+end

data/lib/podio/models/net_promoter_score.rb

@@ -0,0 +1,28 @@
+class Podio::NetPromoterScore < ActivePodio::Base
+  property :nps_id, :integer
+  property :user_id, :integer
+  property :created_on, :datetime
+  property :created_via, :integer
+  property :score, :integer
+  property :feedback, :string
+  property :country_code, :string
+
+  alias_method :id, :nps_id
+
+  class << self
+    def create(attributes=[])
+      member Podio.connection.post { |req|
+        req.url("/nps/")
+        req.body = attributes
+      }.body
+    end
+
+    def update(nps_id, attributes)
+      member Podio.connection.put { |req|
+        req.url("/nps/#{nps_id}")
+        req.body = attributes
+      }.body
+    end
+  end
+
+end