podio 0.4.1 → 0.5.0

data/lib/podio/models/item.rb

@@ -0,0 +1,122 @@
+class Podio::Item < ActivePodio::Base
+
+  # Included Get Item basic
+  property :item_id, :integer
+  property :app, :hash
+  property :external_id, :string
+  property :title, :string
+  property :fields, :array
+  property :rights, :array
+
+  has_one :initial_revision, :class => 'ItemRevision'
+  has_one :current_revision, :class => 'ItemRevision'
+  
+  # Also included in the full Get item
+  property :ratings, :hash
+  property :conversations, :array
+  property :tasks, :array
+  property :references, :array
+  property :tags, :array
+  property :subscribed, :boolean
+  property :user_ratings, :hash
+
+  has_many :revisions, :class => 'ItemRevision'
+  has_many :files, :class => 'FileAttachment'
+  has_many :comments, :class => 'Comment'
+  has_many :shares, :class => 'AppStoreShare'
+
+  # For inserting/updating
+  property :file_ids, :array
+  
+  alias_method :id, :item_id
+  delegate_to_hash :app, :app_id, :app_name, :item_name
+
+  def destroy
+    Item.delete(self.id)
+  end
+  
+  class << self
+    def find(id)
+      member Podio.connection.get("/item/#{id}").body
+    end
+
+    def find_basic(id)
+      member Podio.connection.get("/item/#{id}/basic").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
+
+    def find_all(app_id, options={})
+      collection Podio.connection.get { |req|
+        req.url("/item/app/#{app_id}/", options)
+      }.body
+    end
+    
+    def find_next(current_item_id, time = nil)
+      find_next_or_previous(:next, current_item_id, time)
+    end
+
+    def find_previous(current_item_id, time = nil)
+      find_next_or_previous(:previous, current_item_id, time)
+    end
+    
+    def find_field_top(field_id, options={:limit => 8})
+      list Podio.connection.get { |req|
+        req.url("/item/field/#{field_id}/top/", options)
+      }.body
+    end
+
+    def search_field(field_id, options={})
+      list Podio.connection.get { |req|
+        req.url("/item/field/#{field_id}/find", options)
+      }.body
+    end
+
+    # Deprecated. Use method in ItemRevision instead.
+    # def revisions(item_id)
+    #   collection Podio.connection.get("/item/#{item_id}/revision/").body
+    # end
+
+    # Deprecated. Use method in ItemDiff instead.
+    # def revision_difference(item_id, revision_from_id, revision_to_id)
+    #   list Podio.connection.get{ |req|
+    #     req.url("/item/#{item_id}/revision/#{revision_from_id}/#{revision_to_id}")
+    #   }.body
+    # end
+
+    def create(app_id, attributes)
+      response = Podio.connection.post do |req|
+        req.url "/item/app/#{app_id}/"
+        req.body = attributes
+      end
+
+      response.body['item_id']
+    end
+    
+    def update(id, attributes)
+      response = Podio.connection.put do |req|
+        req.url "/item/#{id}"
+        req.body = attributes
+      end
+      response.status
+    end
+    
+    def delete(id)
+      Podio.connection.delete("/item/#{id}").body
+    end
+    
+    protected
+    
+      def time_options(time)
+        time.present? ? { 'time' => (time.is_a?(String) ? time : time.to_s(:db)) } : {}
+      end
+      
+      def find_next_or_previous(operation, current_item_id, time)
+        member Podio.connection.get { |req|
+          req.url("/item/#{current_item_id}/#{operation}", time_options(time))
+        }.body
+      end    
+  end
+end

data/lib/podio/models/item_diff.rb

@@ -0,0 +1,16 @@
+class Podio::ItemDiff < ActivePodio::Base
+  property :field_id, :integer
+  property :type, :string
+  property :external_id, :integer
+  property :label, :string
+  property :from, :array
+  property :to, :array
+  
+  alias_method :id, :field_id
+  
+  class << self
+    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
+  end
+end

data/lib/podio/models/item_field.rb

@@ -0,0 +1,19 @@
+class Podio::ItemField < ActivePodio::Base
+  property :field_id, :integer
+  property :type, :string
+  property :external_id, :integer
+  property :label, :string
+  property :values, :array
+
+  alias_method :id, :field_id
+  
+  class << self
+    def update(item_id, field_id, values)
+      response = Podio.connection.put do |req|
+        req.url "/item/#{item_id}/value/#{field_id}"
+        req.body = values
+      end
+      response.status
+    end    
+  end
+end

data/lib/podio/models/item_revision.rb

@@ -0,0 +1,18 @@
+class Podio::ItemRevision < ActivePodio::Base
+  property :revision, :integer
+  property :app_revision, :integer
+  property :created_on, :datetime
+
+  has_one :created_by, :class => 'ByLine'
+  has_one :created_via, :class => 'Via'
+  
+  class << self
+    def find(item_id, revision_id)
+      member Podio.connection.get("/item/#{item_id}/revision/#{revision_id}").body
+    end
+
+    def find_all_by_item_id(item_id)
+      list Podio.connection.get("/item/#{item_id}/revision/").body
+    end
+  end
+end

data/lib/podio/models/news.rb

@@ -0,0 +1,83 @@
+class Podio::News < ActivePodio::Base
+  property :news_id, :integer
+  property :title, :string
+  property :content, :string
+  property :link, :string
+  property :priority, :integer
+  property :target_group, :string
+  property :locale, :string
+  property :run_from, :datetime
+  property :run_to, :datetime
+  property :stream_display, :boolean
+  property :email_display, :boolean
+  property :email_views, :integer
+  property :stream_views, :integer
+  property :email_clicks, :integer
+  property :stream_clicks, :integer
+
+  alias_method :id, :news_id
+  
+  class << self
+    def find_stream()
+      Podio.connection.get("/news/stream").body
+    end
+
+    def get_news_redirect(news_id, type=nil)
+      type = type.presence || 'stream'
+      response = Podio.connection.get("/news/#{news_id}/redirect?type=#{type}")
+      response.body['link']
+    end
+
+    def delete(news_id)
+      Podio.connection.delete("/news/#{news_id}")
+    end
+
+    def unsubscribe_entry(news_id)
+      Podio.connection.post do |req|
+        req.url "/news/#{news_id}/unsubscribe"
+      end
+    end
+
+    def create(attributes)
+      response = Podio.connection.post do |req|
+        req.url '/news/'
+        req.body = attributes
+      end
+      response.body['news_id']
+    end
+
+    def update(id, attributes)
+      response = Podio.connection.put do |req|
+        req.url "/news/#{id}"
+        req.body = attributes
+      end
+
+      response.status
+    end
+
+    def find(id, options={})
+      member Podio.connection.get("/news/#{id}").body
+    end
+
+    def find_visible
+      list Podio.connection.get("/news/").body
+    end
+
+    def find_all
+      list Podio.connection.get("/news/").body
+    end
+
+    def find_all_by_locale(locale)
+      list Podio.connection.get('/news/?locale=#{locale}').body
+    end
+
+    def find_all_by_target_group(target_group)
+      list Podio.connection.get('/news/?target_group=#{target_group}').body
+    end
+
+    def find_all_by_locale_and_group(locale, group)
+      list Podio.connection.get('/news/?locale=#{locale}?target_group=#{group}').body
+    end
+    
+  end
+end

data/lib/podio/models/notification.rb

@@ -0,0 +1,47 @@
+class Podio::Notification < ActivePodio::Base
+  property :notification_id, :integer
+  property :user, :hash
+  property :type, :string
+  property :viewed_on, :datetime
+  property :subscription_id, :integer
+  property :created_on, :datetime
+  property :data, :hash
+  property :starred, :boolean
+
+  # Only available when getting a single notification
+  property :space, :hash
+  property :org, :hash
+  property :data_link, :string
+  property :context_type, :string
+  property :context_link, :string
+  property :context, :hash
+
+  has_one :created_by, :class => 'ByLine'
+  has_one :created_via, :class => 'Via'
+  has_one :user, :class => 'User'
+
+  alias_method :id, :notification_id
+  delegate_to_hash :data, :field, :value, :role, :message
+  
+  class << self
+    def find(id)
+      member Podio.connection.get("/notification/#{id}").body
+    end
+
+    def mark_as_viewed(id)
+      Podio.connection.post("/notification/#{id}/viewed").status
+    end
+
+    def mark_all_as_viewed
+      Podio.connection.post("/notification/viewed").status
+    end
+    
+    def star(id)
+      Podio.connection.post("/notification/#{id}/star").status
+    end
+
+    def unstar(id)
+      Podio.connection.delete("/notification/#{id}/star").status
+    end
+  end
+end

data/lib/podio/models/notification_group.rb

@@ -0,0 +1,19 @@
+# This class wraps the response from the Get Notifications API call
+class Podio::NotificationGroup < ActivePodio::Base
+  property :context, :hash
+  property :notifications, :hash
+  delegate_to_hash :context, :ref, :data
+  delegate_to_hash :data, :link
+  
+  class << self
+    def find_all(options={})
+      list Podio.connection.get { |req|
+        req.url('/notification/', options)
+      }.body
+    end
+    
+    def mark_as_viewed_by_ref(ref_type, ref_id)
+      Podio.connection.post("/notification/#{ref_type}/#{ref_id}/viewed").status
+    end
+  end
+end

data/lib/podio/models/o_auth.rb

@@ -0,0 +1,32 @@
+class Podio::OAuth < ActivePodio::Base
+  
+  class << self
+    def authorize(attributes)
+      response = Podio.connection.post do |req|
+        req.url "/oauth/authorize"
+        req.body = attributes
+      end
+
+      response.body
+    end
+
+    def get_info(attributes)
+      response = Podio.connection.post do |req|
+        req.url "/oauth/info"
+        req.body = attributes
+      end
+
+      response.body
+    end
+
+    def get_access_token(attributes)
+      response = Podio.connection.post do |req|
+        req.url "/oauth/token"
+        req.body = attributes
+      end
+
+      response.body
+    end
+  end
+  
+end

data/lib/podio/models/o_auth_client.rb

@@ -0,0 +1,93 @@
+class Podio::OAuthClient < ActivePodio::Base
+  include ActivePodio::Updatable
+
+  property :auth_client_id, :integer
+  property :name, :string
+  property :key, :string
+  property :secret, :string
+  property :url, :string
+  property :domain, :string
+
+  alias_method :id, :auth_client_id
+
+  def create
+    self.auth_client_id = self.class.create(attributes)
+  end
+
+  def update
+    self.class.update(self.auth_client_id, attributes)
+  end
+
+  handle_api_errors_for :create, :update # Call must be made after the methods to handle have been defined
+  
+  class << self
+    def create(attributes)
+      response = Podio.connection.post do |req|
+        req.url "/oauth/client/"
+        req.body = attributes
+      end
+
+      response.body['auth_client_id']
+    end
+
+    def create_admin(user_id, attributes)
+      response = Podio.connection.post do |req|
+        req.url "/oauth/client/user/#{user_id}/"
+        req.body = attributes
+      end
+
+      response.status
+    end
+
+    def update(id, attributes)
+      response = Podio.connection.put do |req|
+        req.url "/oauth/client/#{id}"
+        req.body = attributes
+      end
+
+      response.status
+    end
+
+    def update_admin(id, attributes)
+      response = Podio.connection.put do |req|
+        req.url "/oauth/client/#{id}/admin"
+        req.body = attributes
+      end
+
+      response.status
+    end
+
+    def delete(id)``
+      response = Podio.connection.delete("/oauth/client/#{id}")
+
+      response.status
+    end
+
+    def delete_grant(id)
+       response = Podio.connection.delete("/oauth/grant/client/#{id}")
+
+       response.status
+    end
+
+    def reset(id)
+       response = Podio.connection.post("/oauth/client/#{id}/reset")
+       response.status
+     end
+
+    def find_granted_clients()
+      list Podio.connection.get("oauth/grant/client/").body
+    end
+
+    def find_all_for_current_user()
+      list Podio.connection.get("oauth/client/").body
+    end
+
+    def find_all_for_user(user_id)
+      list Podio.connection.get("oauth/client/user/#{user_id}/").body
+    end
+
+    def find(client_id)
+      member Podio.connection.get("oauth/client/#{client_id}").body
+    end
+  end
+end

data/lib/podio/{areas → models}/organization.rb

@@ -1,8 +1,41 @@
-module Podio
-  module Organization
-    include Podio::ResponseWrapper
-    extend self
-    
+class Podio::Organization < ActivePodio::Base
+  include ActivePodio::Updatable
+
+  property :org_id, :integer
+  property :name, :string
+  property :logo, :integer
+  property :image, :hash
+  property :spaces, :hash
+  property :url, :string
+  property :url_label, :string
+  property :premium, :boolean
+  property :role, :string
+  property :status, :string
+  property :sales_agent_id, :integer
+  property :created_on, :datetime
+  property :user_limit, :integer
+  property :member_count, :integer
+  property :contact_count, :integer
+  property :billing_interval, :integer
+
+  has_one :created_by, :class => 'ByLine'
+
+  alias_method :id, :org_id
+
+  def create
+    attributes = Organization.create(:name => name)
+    self.org_id = attributes['org_id']
+    self.url = attributes['url']
+    self.url_label = attributes['url_label']
+  end
+
+  def update
+    Organization.update(id, {:name => name, :logo => logo, :url_label => url_label, :billing_interval => billing_interval})
+  end
+  
+  handle_api_errors_for :create, :update # Call must be made after the methods to handle have been defined  
+  
+  class << self
     def update(id, attributes)
       response = Podio.connection.put do |req|
         req.url "/org/#{id}"
@@ -64,6 +97,6 @@ module Podio
     def upgrade(id)
       Podio.connection.post("/org/#{id}/upgrade").body
     end
-  
+    
   end
 end

data/lib/podio/models/organization_contact.rb

@@ -0,0 +1,14 @@
+# Encapsulates a primary contact for an organization, primarily used for billing purposes
+class Podio::OrganizationContact < Podio::Profile
+  include ActivePodio::Updatable
+
+  property :org_id, :integer
+  property :attention, :string # The name of the primary organization contact
+  
+  alias_method :id, :org_id
+
+  def save
+    Organization.update_billing_profile(id, self.attributes)
+  end
+
+end

data/lib/podio/{areas → models}/organization_member.rb

@@ -1,8 +1,16 @@
-module Podio
-  module OrganizationMember
-    include Podio::ResponseWrapper
-    extend self
+# Encapsulates a user's indirect membership (through spaces) of an organization.
+class Podio::OrganizationMember < ActivePodio::Base
+  property :spaces, :hash
+  property :profile, :hash
+  property :admin, :boolean
 
+  has_one :user, :class => 'User'
+  has_one :contact, :class => 'Contact', :property => :profile
+
+  delegate :user_id, :mail, :last_active_on, :to => :user
+  delegate :name, :avatar, :title, :organization, :title_and_org, :avatar_url, :to => :contact
+  
+  class << self
     def find_all_for_org(org_id, options = {})
       list Podio.connection.get { |req|
         req.url("/org/#{org_id}/member/", options)
@@ -30,4 +38,4 @@ module Podio
     end
     
   end
-end
+end

data/lib/podio/models/organization_profile.rb

@@ -0,0 +1,61 @@
+# Encapsulates an organization profile, primarily used for in app store
+class Podio::OrganizationProfile < ActivePodio::Base
+  include ActivePodio::Updatable
+
+  property :org_id, :integer
+  property :avatar, :integer
+  property :name, :string
+  property :mail, :array
+  property :phone, :array
+  property :url, :array
+  property :address, :array
+  property :city, :string
+  property :country, :string
+  property :about, :string
+
+  alias_method :id, :org_id
+  alias_method :logo, :avatar
+  alias_method :logo=, :avatar=
+
+  def create
+    self.class.create(self.org_id, self.attributes)
+  end
+
+  def update
+    self.class.update(self.org_id, self.attributes)
+  end
+
+  def destroy
+    self.class.delete(self.org_id)
+  end
+
+  handle_api_errors_for :create, :update # Call must be made after the methods to handle have been defined  
+
+  class << self
+    def find(org_id)
+      member Podio.connection.get("/org/#{org_id}/appstore").body
+    end
+
+    def create(org_id, attributes)
+      response = Podio.connection.post do |req|
+        req.url "/org/#{org_id}/appstore"
+        req.body = attributes
+      end
+
+      response.body
+    end
+
+    def update(org_id, attributes)
+      response = Podio.connection.put do |req|
+        req.url "/org/#{org_id}/appstore"
+        req.body = attributes
+      end
+      response.status
+    end
+
+    def delete(org_id)
+      Podio.connection.delete("/org/#{org_id}/appstore").status
+    end
+  end
+
+end

data/lib/podio/{areas/contact.rb → models/profile.rb}

@@ -1,8 +1,26 @@
-module Podio
-  module Contact
-    include Podio::ResponseWrapper
-    extend self
-
+# Serves as the base for Contacts and Organization Contacts
+class Podio::Profile < ActivePodio::Base
+  property :profile_id, :integer
+  property :name, :string
+  property :avatar, :integer
+  property :image, :hash
+  property :birthdate, :date
+  property :department, :string
+  property :vatin, :string
+  property :skype, :string
+  property :about, :string
+  property :address, :array
+  property :zip, :string
+  property :city, :string
+  property :country, :string
+  property :im, :array
+  property :location, :array
+  property :mail, :array
+  property :phone, :array
+  property :title, :array
+  property :url, :array
+  
+  class << self
     def all(options={})
       options[:exclude_self] = (options[:exclude_self] == false ? "0" : "1" )
 
@@ -106,5 +124,4 @@ module Podio
     end
     
   end
-
 end

data/lib/podio/{areas → models}/rating.rb

@@ -1,8 +1,6 @@
-module Podio
-  module Rating
-    include Podio::ResponseWrapper
-    extend self
-
+class Podio::Rating < ActivePodio::Base
+  
+  class << self
     def create(ref_type, ref_id, rating_type, value)
       response = Podio.connection.post do |req|
         req.url "/rating/#{ref_type}/#{ref_id}/#{rating_type}"
@@ -31,6 +29,6 @@ module Podio
     def delete(ref_type, ref_id, rating_type)
       Podio.connection.delete("/rating/#{ref_type}/#{ref_id}/#{rating_type}").body
     end
-
   end
-end
+  
+end

data/lib/podio/{areas → models}/search.rb

@@ -1,8 +1,6 @@
-module Podio
-  module Search
-    include Podio::ResponseWrapper
-    extend self
-
+class Podio::Search < ActivePodio::Base
+  
+  class << self
     def in_org(org_id, words)
       response = Podio.connection.post do |req|
         req.url "/search/org/#{org_id}/"
@@ -10,6 +8,7 @@ module Podio
       end
 
       list response.body
-    end
+    end    
   end
-end
+  
+end