kentaa-api 0.6.0 → 0.7.1

data/lib/kentaa/api/resources/company_package.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Kentaa
+  module Api
+    module Resources
+      class CompanyPackage
+        attr_reader :data
+
+        def initialize(data)
+          @data = data
+        end
+
+        def id
+          data[:id]
+        end
+
+        def created_at
+          Time.parse(data[:created_at]) if data[:created_at]
+        end
+
+        def updated_at
+          Time.parse(data[:updated_at]) if data[:updated_at]
+        end
+
+        def amount
+          data[:amount]
+        end
+
+        def title
+          data[:title]
+        end
+
+        def description
+          data[:description]
+        end
+      end
+    end
+  end
+end

data/lib/kentaa/api/resources/consent.rb

@@ -1,25 +1,102 @@
 # frozen_string_literal: true
 
+require 'time'
+
 module Kentaa
   module Api
     module Resources
       class Consent
+        STATUS_GRANTED = 'granted'
+        STATUS_REVOKED = 'revoked'
+
+        TYPE_TERMS_CONDITIONS = 'terms_conditions'
+        TYPE_PROCESSING_PERSONAL_DATA = 'processing_personal_data'
+        TYPE_PROCESSING_PERSONAL_SENSITIVE_DATA = 'processing_personal_sensitive_data'
+        TYPE_NEWSLETTER_SUBSCRIPTION = 'newsletter_subscription'
+        TYPE_NEWS_ITEM_SUBSCRIPTION = 'news_item_subscription'
+        TYPE_CONTACT_PHONE = 'contact_phone'
+        TYPE_CONTACT_PHONE_COMMERCIAL = 'contact_phone_commercial'
+
         attr_reader :data
 
         def initialize(data)
           @data = data
         end
 
-        def url
-          data[:url]
+        def consent_type
+          data[:consent_type]
+        end
+
+        def terms_conditions?
+          consent_type == TYPE_TERMS_CONDITIONS
+        end
+
+        def processing_personal_data?
+          consent_type == TYPE_PROCESSING_PERSONAL_DATA
+        end
+
+        def processing_personal_sensitive_data?
+          consent_type == TYPE_PROCESSING_PERSONAL_SENSITIVE_DATA
+        end
+
+        def newsletter_subscription?
+          consent_type == TYPE_NEWSLETTER_SUBSCRIPTION
+        end
+
+        def news_item_subscription?
+          consent_type == TYPE_NEWS_ITEM_SUBSCRIPTION
+        end
+
+        def contact_phone?
+          consent_type == TYPE_CONTACT_PHONE
+        end
+
+        def contact_phone_commercial?
+          consent_type == TYPE_CONTACT_PHONE_COMMERCIAL
+        end
+
+        def consent_status
+          data[:consent_status]
+        end
+
+        def granted?
+          consent_status == STATUS_GRANTED
+        end
+
+        def revoked?
+          consent_status == STATUS_REVOKED
+        end
+
+        def granted_at
+          Time.parse(data[:granted_at])
+        end
+
+        def revoked_at
+          Time.parse(data[:revoked_at]) if data[:revoked_at]
+        end
+
+        def consent_text
+          data[:consent_text]
         end
 
         def text
-          data[:text]
+          data[:text] || data[:consent_text]
+        end
+
+        def url
+          data[:url]
         end
 
         def version
-          data[:version]
+          data[:version] || data[:terms_conditions_version]
+        end
+
+        def terms_conditions_version
+          data[:terms_conditions_version]
+        end
+
+        def privacy_version
+          data[:privacy_version]
         end
       end
     end

data/lib/kentaa/api/resources/contact.rb

@@ -23,7 +23,7 @@ module Kentaa
         end
 
         def name
-          [first_name, infix, last_name].reject { |s| s.to_s.empty? }.join(" ")
+          [first_name, infix, last_name].reject { |s| s.to_s.empty? }.join(' ')
         end
 
         def email

data/lib/kentaa/api/resources/donation.rb

@@ -16,6 +16,8 @@ module Kentaa
             Kentaa::Api::Resources::Action.new(config, id: action_id, options: options)
           elsif team_id
             Kentaa::Api::Resources::Team.new(config, id: team_id, options: options)
+          elsif company_id
+            Kentaa::Api::Resources::Company.new(config, id: company_id, options: options)
           elsif project_id
             Kentaa::Api::Resources::Project.new(config, id: project_id, options: options)
           elsif segment_id
@@ -27,6 +29,10 @@ module Kentaa
           end
         end
 
+        def recurring_donor
+          Kentaa::Api::Resources::RecurringDonor.new(config, id: recurring_donor_id, options: options) if recurring_donor_id
+        end
+
         def site
           Kentaa::Api::Resources::Site.new(config, id: site_id, options: options)
         end
@@ -47,6 +53,10 @@ module Kentaa
           data[:project_id]
         end
 
+        def company_id
+          data[:company_id]
+        end
+
         def team_id
           data[:team_id]
         end
@@ -55,6 +65,10 @@ module Kentaa
           data[:action_id]
         end
 
+        def recurring_donor_id
+          data[:recurring_donor_id]
+        end
+
         def first_name
           data[:first_name]
         end
@@ -68,7 +82,7 @@ module Kentaa
         end
 
         def name
-          [first_name, infix, last_name].reject { |s| s.to_s.empty? }.join(" ")
+          [first_name, infix, last_name].reject { |s| s.to_s.empty? }.join(' ')
         end
 
         def company
@@ -79,6 +93,10 @@ module Kentaa
           data[:anonymous]
         end
 
+        def contact_details_type
+          data[:contact_details_type]
+        end
+
         def email
           data[:email]
         end
@@ -99,6 +117,10 @@ module Kentaa
           data[:locale]
         end
 
+        def frequency_type
+          data[:frequency_type]
+        end
+
         def currency
           data[:currency]
         end
@@ -214,9 +236,25 @@ module Kentaa
         end
 
         def consent
+          Kentaa::Api::Deprecation.warn('#consent is deprecated. Please use #consents instead.', caller)
+
           @consent ||= Kentaa::Api::Resources::Consent.new(data[:consent]) if data[:consent]
         end
 
+        def consents
+          @consents ||= begin
+            consents = []
+
+            if data[:consents]
+              data[:consents].each do |consent|
+                consents << Kentaa::Api::Resources::Consent.new(consent)
+              end
+            end
+
+            consents
+          end
+        end
+
         private
 
         def load_resource

data/lib/kentaa/api/resources/manual_donation.rb

@@ -16,6 +16,8 @@ module Kentaa
             Kentaa::Api::Resources::Action.new(config, id: action_id, options: options)
           elsif team_id
             Kentaa::Api::Resources::Team.new(config, id: team_id, options: options)
+          elsif company_id
+            Kentaa::Api::Resources::Company.new(config, id: company_id, options: options)
           elsif project_id
             Kentaa::Api::Resources::Project.new(config, id: project_id, options: options)
           elsif segment_id
@@ -43,6 +45,10 @@ module Kentaa
           data[:segment_id]
         end
 
+        def company_id
+          data[:company_id]
+        end
+
         def project_id
           data[:project_id]
         end
@@ -68,7 +74,7 @@ module Kentaa
         end
 
         def name
-          [first_name, infix, last_name].reject { |s| s.to_s.empty? }.join(" ")
+          [first_name, infix, last_name].reject { |s| s.to_s.empty? }.join(' ')
         end
 
         def anonymous?
@@ -106,7 +112,7 @@ module Kentaa
         end
 
         def create_resource(attributes)
-          request.post("/manual-donations", options, attributes)
+          request.post('/manual-donations', options, attributes)
         end
 
         def update_resource(attributes)

data/lib/kentaa/api/resources/newsletter_subscription.rb

@@ -37,7 +37,7 @@ module Kentaa
         end
 
         def name
-          [first_name, infix, last_name].reject { |s| s.to_s.empty? }.join(" ")
+          [first_name, infix, last_name].reject { |s| s.to_s.empty? }.join(' ')
         end
 
         def site_id
@@ -69,9 +69,25 @@ module Kentaa
         end
 
         def consent
+          Kentaa::Api::Deprecation.warn('#consent is deprecated. Please use #consents instead.', caller)
+
           @consent ||= Kentaa::Api::Resources::Consent.new(data[:consent]) if data[:consent]
         end
 
+        def consents
+          @consents ||= begin
+            consents = []
+
+            if data[:consents]
+              data[:consents].each do |consent|
+                consents << Kentaa::Api::Resources::Consent.new(consent)
+              end
+            end
+
+            consents
+          end
+        end
+
         private
 
         def load_resource

data/lib/kentaa/api/resources/performance.rb

@@ -23,6 +23,10 @@ module Kentaa
           data[:title]
         end
 
+        def description
+          data[:description]
+        end
+
         def performance_type
           data[:performance_type]
         end
@@ -39,6 +43,10 @@ module Kentaa
           data[:unit]
         end
 
+        def photos(options = {})
+          @photos ||= Kentaa::Api::Resources::List.new(config, options.merge(resource_class: Kentaa::Api::Resources::PerformancePhoto, endpoint_path: "/actions/#{action_id}/performances/#{id}/photos"))
+        end
+
         private
 
         def load_resource

data/lib/kentaa/api/resources/performance_photo.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Kentaa
+  module Api
+    module Resources
+      class PerformancePhoto < Resource
+        class << self
+          def attribute_key
+            'photo'
+          end
+        end
+
+        def object_key
+          "ActionPerformancePhoto_#{id}"
+        end
+
+        def image_url
+          data[:image_url]
+        end
+
+        private
+
+        def load_resource
+          request.get("#{endpoint_path}/#{id}", options)
+        end
+
+        def create_resource(attributes)
+          io = attributes.fetch(:io)
+          content_type = attributes.fetch(:content_type)
+
+          request.post(endpoint_path, options, io, content_type: content_type)
+        end
+      end
+    end
+  end
+end

data/lib/kentaa/api/resources/project.rb

@@ -134,9 +134,25 @@ module Kentaa
         end
 
         def consent
+          Kentaa::Api::Deprecation.warn('#consent is deprecated. Please use #consents instead.', caller)
+
           @consent ||= Kentaa::Api::Resources::Consent.new(data[:consent]) if data[:consent]
         end
 
+        def consents
+          @consents ||= begin
+            consents = []
+
+            if data[:consents]
+              data[:consents].each do |consent|
+                consents << Kentaa::Api::Resources::Consent.new(consent)
+              end
+            end
+
+            consents
+          end
+        end
+
         def contact
           @contact ||= Kentaa::Api::Resources::Contact.new(data[:contact]) if data[:contact]
         end

data/lib/kentaa/api/resources/recurring_donor.rb

@@ -44,7 +44,7 @@ module Kentaa
         end
 
         def name
-          [first_name, infix, last_name].reject { |s| s.to_s.empty? }.join(" ")
+          [first_name, infix, last_name].reject { |s| s.to_s.empty? }.join(' ')
         end
 
         def company

data/lib/kentaa/api/resources/site.rb

@@ -86,21 +86,21 @@ module Kentaa
         end
 
         def donations
-          @donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Donation, endpoint_path: "/donations")
+          @donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Donation, endpoint_path: '/donations')
         end
 
         def manual_donations
-          @manual_donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::ManualDonation, endpoint_path: "/manual-donations")
+          @manual_donations ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::ManualDonation, endpoint_path: '/manual-donations')
         end
 
         def newsletter_subscriptions
-          @newsletter_subscriptions ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::NewsletterSubscription, endpoint_path: "/newsletter-subscriptions")
+          @newsletter_subscriptions ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::NewsletterSubscription, endpoint_path: '/newsletter-subscriptions')
         end
 
         private
 
         def load_resource
-          request.get("/sites/current", options)
+          request.get('/sites/current', options)
         end
       end
     end

data/lib/kentaa/api/resources/user.rb

@@ -31,7 +31,7 @@ module Kentaa
         end
 
         def name
-          [first_name, infix, last_name].reject { |s| s.to_s.empty? }.join(" ")
+          [first_name, infix, last_name].reject { |s| s.to_s.empty? }.join(' ')
         end
 
         def email
@@ -91,9 +91,29 @@ module Kentaa
         end
 
         def consent
+          Kentaa::Api::Deprecation.warn('#consent is deprecated. Please use #consents instead.', caller)
+
           @consent ||= Kentaa::Api::Resources::Consent.new(data[:consent]) if data[:consent]
         end
 
+        def consents
+          @consents ||= begin
+            consents = []
+
+            if data[:consents]
+              data[:consents].each do |consent|
+                consents << Kentaa::Api::Resources::Consent.new(consent)
+              end
+            end
+
+            consents
+          end
+        end
+
+        def actions
+          @actions ||= Kentaa::Api::Resources::List.new(config, resource_class: Kentaa::Api::Resources::Action, endpoint_path: "/users/#{id}/actions")
+        end
+
         private
 
         def load_resource
@@ -101,7 +121,7 @@ module Kentaa
         end
 
         def create_resource(attributes)
-          request.post("/users", options, attributes)
+          request.post('/users', options, attributes)
         end
 
         def update_resource(attributes)

data/lib/kentaa/api/resources/users.rb

@@ -5,7 +5,7 @@ module Kentaa
     module Resources
       class Users < List
         def initialize(config, options = {})
-          super(config, options.merge(resource_class: Kentaa::Api::Resources::User, endpoint_path: "/users"))
+          super(config, options.merge(resource_class: Kentaa::Api::Resources::User, endpoint_path: '/users'))
         end
 
         def auth(attributes, options = {})

data/lib/kentaa/api/util.rb

@@ -6,7 +6,11 @@ module Kentaa
       module_function
 
       def pluralize(string)
-        "#{string}s"
+        if string[-1] == 'y'
+          "#{string.chop}ies"
+        else
+          "#{string}s"
+        end
       end
     end
   end

data/lib/kentaa/api/version.rb

@@ -2,6 +2,6 @@
 
 module Kentaa
   module Api
-    VERSION = "0.6.0"
+    VERSION = '0.7.1'
   end
 end

data/lib/kentaa/api.rb

@@ -1,41 +1,46 @@
 # frozen_string_literal: true
 
-require_relative "api/resources/base"
-require_relative "api/resources/error"
-require_relative "api/resources/list"
-require_relative "api/resources/resource"
+require_relative 'api/resources/base'
+require_relative 'api/resources/error'
+require_relative 'api/resources/list'
+require_relative 'api/resources/resource'
 
-require_relative "api/resources/action"
-require_relative "api/resources/activity"
-require_relative "api/resources/address"
-require_relative "api/resources/banner"
-require_relative "api/resources/consent"
-require_relative "api/resources/contact"
-require_relative "api/resources/donation_form"
-require_relative "api/resources/donation"
-require_relative "api/resources/location"
-require_relative "api/resources/manual_donation"
-require_relative "api/resources/newsletter_subscription"
-require_relative "api/resources/performance"
-require_relative "api/resources/photo"
-require_relative "api/resources/project"
-require_relative "api/resources/recurring_donor"
-require_relative "api/resources/registration_fee"
-require_relative "api/resources/reward"
-require_relative "api/resources/question"
-require_relative "api/resources/segment"
-require_relative "api/resources/site"
-require_relative "api/resources/sites"
-require_relative "api/resources/team"
-require_relative "api/resources/user"
-require_relative "api/resources/users"
-require_relative "api/resources/video"
+require_relative 'api/resources/action'
+require_relative 'api/resources/activity'
+require_relative 'api/resources/address'
+require_relative 'api/resources/banner'
+require_relative 'api/resources/billing'
+require_relative 'api/resources/company'
+require_relative 'api/resources/company_package'
+require_relative 'api/resources/consent'
+require_relative 'api/resources/contact'
+require_relative 'api/resources/donation_form'
+require_relative 'api/resources/donation'
+require_relative 'api/resources/location'
+require_relative 'api/resources/manual_donation'
+require_relative 'api/resources/newsletter_subscription'
+require_relative 'api/resources/performance'
+require_relative 'api/resources/performance_photo'
+require_relative 'api/resources/photo'
+require_relative 'api/resources/project'
+require_relative 'api/resources/recurring_donor'
+require_relative 'api/resources/registration_fee'
+require_relative 'api/resources/reward'
+require_relative 'api/resources/question'
+require_relative 'api/resources/segment'
+require_relative 'api/resources/site'
+require_relative 'api/resources/sites'
+require_relative 'api/resources/team'
+require_relative 'api/resources/user'
+require_relative 'api/resources/users'
+require_relative 'api/resources/video'
 
-require_relative "api/client"
-require_relative "api/config"
-require_relative "api/exception"
-require_relative "api/request"
-require_relative "api/response"
-require_relative "api/util"
+require_relative 'api/client'
+require_relative 'api/config'
+require_relative 'api/deprecation'
+require_relative 'api/exception'
+require_relative 'api/request'
+require_relative 'api/response'
+require_relative 'api/util'
 
-require_relative "api/version"
+require_relative 'api/version'