tito_ruby 0.1.0

data/lib/tito/admin/resources/interested_user.rb

@@ -0,0 +1,19 @@
+module Tito
+  module Admin
+    module Resources
+      class InterestedUser < Tito::Resource
+        event_scoped!
+        path_template "%{account}/%{event}/interested_users"
+        resource_name "interested_user"
+        collection_name "interested_users"
+        supports :list, :show, :create, :update, :delete
+
+        attribute :id,         :integer
+        attribute :email,      :string
+        attribute :name,       :string
+        attribute :created_at, :datetime
+        attribute :updated_at, :datetime
+      end
+    end
+  end
+end

data/lib/tito/admin/resources/opt_in.rb

@@ -0,0 +1,23 @@
+module Tito
+  module Admin
+    module Resources
+      class OptIn < Tito::Resource
+        event_scoped!
+        path_template "%{account}/%{event}/opt_ins"
+        resource_name "opt_in"
+        collection_name "opt_ins"
+        supports :list, :show, :create, :update, :delete
+
+        attribute :id,               :integer
+        attribute :slug,             :string
+        attribute :name,             :string
+        attribute :description,      :string
+        attribute :acceptance_count, :integer
+        attribute :created_at,       :datetime
+        attribute :updated_at,       :datetime
+
+        expandable :releases
+      end
+    end
+  end
+end

data/lib/tito/admin/resources/question.rb

@@ -0,0 +1,30 @@
+module Tito
+  module Admin
+    module Resources
+      class Question < Tito::Resource
+        event_scoped!
+        path_template "%{account}/%{event}/questions"
+        resource_name "question"
+        collection_name "questions"
+        supports :list, :show, :create, :update, :delete
+
+        attribute :id,                      :integer
+        attribute :slug,                    :string
+        attribute :title,                   :string
+        attribute :description,             :string
+        attribute :field_type,              :string
+        attribute :options,                 :string
+        attribute :include_free_text_field, :boolean
+        attribute :required,               :boolean
+        attribute :answers_count,          :integer
+        attribute :tickets_count,          :integer
+        attribute :created_at,             :datetime
+        attribute :updated_at,             :datetime
+
+        expandable :activities, :releases
+
+        has_many :answers, resource_class_name: "Answer"
+      end
+    end
+  end
+end

data/lib/tito/admin/resources/refund.rb

@@ -0,0 +1,20 @@
+module Tito
+  module Admin
+    module Resources
+      class Refund < Tito::Resource
+        event_scoped!
+        path_template "%{account}/%{event}/registrations/%{parent_id}/refunds"
+        resource_name "refund"
+        collection_name "refunds"
+        supports :list, :show
+
+        attribute :id,         :integer
+        attribute :amount,     :decimal
+        attribute :manual,     :boolean
+        attribute :created_at, :datetime
+
+        expandable :registration
+      end
+    end
+  end
+end

data/lib/tito/admin/resources/registration.rb

@@ -0,0 +1,49 @@
+module Tito
+  module Admin
+    module Resources
+      class Registration < Tito::Resource
+        event_scoped!
+        path_template "%{account}/%{event}/registrations"
+        resource_name "registration"
+        collection_name "registrations"
+        supports :list, :show, :create, :update
+
+        attribute :id,                  :integer
+        attribute :slug,                :string
+        attribute :reference,           :string
+        attribute :email,               :string
+        attribute :name,                :string
+        attribute :phone_number,        :string
+        attribute :job_title,           :string
+        attribute :company_name,        :string
+        attribute :payment_reference,   :string
+        attribute :total,               :decimal
+        attribute :total_less_tax,      :decimal
+        attribute :paid,                :boolean
+        attribute :payment_complete,    :boolean
+        attribute :payment_incomplete,  :boolean
+        attribute :cancelled,           :boolean
+        attribute :cancelled_at,        :datetime
+        attribute :completed_at,        :datetime
+        attribute :consented_at,        :datetime
+        attribute :locale,              :string
+        attribute :metadata,            :string
+        attribute :discount_code_id,    :integer
+        attribute :imported,            :boolean
+        attribute :manual,              :boolean
+        attribute :test_mode,           :boolean
+        attribute :created_at,          :datetime
+        attribute :updated_at,          :datetime
+
+        expandable :billing_address, :receipts, :refunds, :tickets, :line_items
+
+        action :confirm!,   method: :post,   path: "confirmations"
+        action :unconfirm!, method: :delete, path: "confirmations"
+        action :refund!,    method: :post,   path: "refunds"
+        action :cancel!,    method: :post,   path: "cancellation"
+
+        has_many :refunds, resource_class_name: "Refund"
+      end
+    end
+  end
+end

data/lib/tito/admin/resources/release.rb

@@ -0,0 +1,67 @@
+module Tito
+  module Admin
+    module Resources
+      class Release < Tito::Resource
+        event_scoped!
+        path_template "%{account}/%{event}/releases"
+        resource_name "release"
+        collection_name "releases"
+        supports :list, :show, :create, :update, :delete
+
+        attribute :id,                              :integer
+        attribute :slug,                            :string
+        attribute :title,                           :string
+        attribute :description,                     :string
+        attribute :event_id,                        :integer
+        attribute :price,                           :decimal
+        attribute :price_ex_tax,                    :decimal
+        attribute :display_price,                   :string
+        attribute :payment_type,                    :string
+        attribute :quantity,                        :integer
+        attribute :tickets_count,                   :integer
+        attribute :allocatable,                     :integer
+        attribute :sold_out,                        :boolean
+        attribute :archived,                        :boolean
+        attribute :off_sale,                        :boolean
+        attribute :locked,                          :boolean
+        attribute :expired,                         :boolean
+        attribute :upcoming,                        :boolean
+        attribute :secret,                          :boolean
+        attribute :not_a_ticket,                    :boolean
+        attribute :lock_changes,                    :boolean
+        attribute :only_issue_combos,               :boolean
+        attribute :card_payments,                   :boolean
+        attribute :invoice,                         :boolean
+        attribute :donation,                        :boolean
+        attribute :require_email,                   :boolean
+        attribute :require_name,                    :boolean
+        attribute :require_billing_address,         :boolean
+        attribute :require_company_name,            :boolean
+        attribute :require_vat_number,              :boolean
+        attribute :show_price,                      :boolean
+        attribute :show_qr_code,                    :boolean
+        attribute :show_discount_code_field_here,   :boolean
+        attribute :max_tickets_per_person,          :integer
+        attribute :min_tickets_per_person,          :integer
+        attribute :start_at,                        :datetime
+        attribute :end_at,                          :datetime
+        attribute :success_message,                 :string
+        attribute :fail_message,                    :string
+        attribute :metadata,                        :string
+        attribute :tax_exclusive,                   :boolean
+        attribute :created_at,                      :datetime
+        attribute :updated_at,                      :datetime
+
+        expandable :activities, :activity_questions, :combo_releases, :questions, :super_combo_releases, :tax_components, :tax_types, :termset, :ticket_group
+
+        action :archive!,    method: :post,   path: "archival"
+        action :unarchive!,  method: :delete, path: "archival"
+        action :activate!,   method: :patch,  path: "activation"
+        action :deactivate!, method: :patch,  path: "deactivation"
+        action :publish!,    method: :post,   path: "publication"
+        action :unpublish!,  method: :delete, path: "publication"
+        action :duplicate,   method: :post,   path: "duplication"
+      end
+    end
+  end
+end

data/lib/tito/admin/resources/release_invitation.rb

@@ -0,0 +1,32 @@
+module Tito
+  module Admin
+    module Resources
+      class ReleaseInvitation < Tito::Resource
+        event_scoped!
+        path_template "%{account}/%{event}/rsvp_lists/%{parent_id}/release_invitations"
+        resource_name "release_invitation"
+        collection_name "release_invitations"
+        supports :list, :show, :create, :update, :delete
+
+        attribute :id,             :integer
+        attribute :slug,           :string
+        attribute :email,          :string
+        attribute :first_name,     :string
+        attribute :last_name,      :string
+        attribute :name,           :string
+        attribute :status,         :string
+        attribute :redeemed,       :boolean
+        attribute :auto,           :boolean
+        attribute :guest,          :boolean
+        attribute :discount_code,  :string
+        attribute :expires_at,     :datetime
+        attribute :unique_url,     :string
+        attribute :redirect,       :string
+        attribute :created_at,     :datetime
+        attribute :updated_at,     :datetime
+
+        expandable :registration
+      end
+    end
+  end
+end

data/lib/tito/admin/resources/rsvp_list.rb

@@ -0,0 +1,26 @@
+module Tito
+  module Admin
+    module Resources
+      class RsvpList < Tito::Resource
+        event_scoped!
+        path_template "%{account}/%{event}/rsvp_lists"
+        resource_name "rsvp_list"
+        collection_name "rsvp_lists"
+        supports :list, :show, :create, :update, :delete
+
+        attribute :id,                         :integer
+        attribute :slug,                       :string
+        attribute :title,                      :string
+        attribute :redeemed_count,             :integer
+        attribute :nos_count,                  :integer
+        attribute :maybes_count,               :integer
+        attribute :release_invitations_count,  :integer
+        attribute :message_slug,               :string
+        attribute :created_at,                 :datetime
+        attribute :updated_at,                 :datetime
+
+        has_many :release_invitations, resource_class_name: "ReleaseInvitation"
+      end
+    end
+  end
+end

data/lib/tito/admin/resources/ticket.rb

@@ -0,0 +1,59 @@
+module Tito
+  module Admin
+    module Resources
+      class Ticket < Tito::Resource
+        event_scoped!
+        path_template "%{account}/%{event}/tickets"
+        resource_name "ticket"
+        collection_name "tickets"
+        supports :list, :show, :create, :update
+
+        attribute :id,                  :integer
+        attribute :slug,                :string
+        attribute :reference,           :string
+        attribute :number,              :integer
+        attribute :email,               :string
+        attribute :first_name,          :string
+        attribute :last_name,           :string
+        attribute :name,                :string
+        attribute :company_name,        :string
+        attribute :job_title,           :string
+        attribute :phone_number,        :string
+        attribute :state,               :string
+        attribute :price,               :decimal
+        attribute :price_less_tax,      :decimal
+        attribute :total_paid,          :decimal
+        attribute :total_paid_less_tax, :decimal
+        attribute :total_tax_paid,      :decimal
+        attribute :release_id,          :integer
+        attribute :release_archived,    :boolean
+        attribute :registration_id,     :integer
+        attribute :discount_code_used,  :string
+        attribute :tag_names,           :string_array
+        attribute :test_mode,           :boolean
+        attribute :assigned,            :boolean
+        attribute :unique_url,          :string
+        attribute :avatar_url,          :string
+        attribute :qr_url,              :string
+        attribute :qr_code_disabled,    :boolean
+        attribute :show_qr_code,        :boolean
+        attribute :vcard_url,           :string
+        attribute :vcard_data,          :string
+        attribute :changes_locked,      :boolean
+        attribute :lock_changes,        :boolean
+        attribute :tags,                :string
+        attribute :event,               :string
+        attribute :void,                :boolean
+        attribute :metadata,            :json
+        attribute :consented_at,        :datetime
+        attribute :created_at,          :datetime
+        attribute :updated_at,          :datetime
+
+        expandable :activities, :answers, :opt_ins, :registration, :release, :responses, :upgrade_ids
+
+        action :void!,     method: :post, path: "void"
+        action :reassign!, method: :post, path: "reassignments"
+      end
+    end
+  end
+end

data/lib/tito/admin/resources/venue.rb

@@ -0,0 +1,19 @@
+module Tito
+  module Admin
+    module Resources
+      class Venue < Tito::Resource
+        event_scoped!
+        path_template "%{account}/%{event}/venues"
+        resource_name "venue"
+        collection_name "venues"
+        supports :list, :show, :create, :update, :delete
+
+        attribute :id,         :integer
+        attribute :name,       :string
+        attribute :address,    :string
+        attribute :created_at, :datetime
+        attribute :updated_at, :datetime
+      end
+    end
+  end
+end

data/lib/tito/admin/resources/waitlisted_person.rb

@@ -0,0 +1,35 @@
+module Tito
+  module Admin
+    module Resources
+      class WaitlistedPerson < Tito::Resource
+        event_scoped!
+        path_template "%{account}/%{event}/waitlisted_people"
+        resource_name "waitlisted_person"
+        collection_name "waitlisted_people"
+        supports :list, :show, :create, :update, :delete
+
+        attribute :id,               :integer
+        attribute :release_id,       :integer
+        attribute :name,             :string
+        attribute :email,            :string
+        attribute :state,            :string
+        attribute :status,           :string
+        attribute :offered_at,       :datetime
+        attribute :offered,          :boolean
+        attribute :expires_at,       :datetime
+        attribute :expired,          :boolean
+        attribute :unique_offer_url, :string
+        attribute :joined_at,        :datetime
+        attribute :joined,           :boolean
+        attribute :redeemed_at,      :datetime
+        attribute :redeemed,         :boolean
+        attribute :rejected,         :boolean
+        attribute :message,          :string
+        attribute :created_at,       :datetime
+        attribute :updated_at,       :datetime
+
+        expandable :registration, :release
+      end
+    end
+  end
+end

data/lib/tito/admin/resources/webhook_endpoint.rb

@@ -0,0 +1,20 @@
+module Tito
+  module Admin
+    module Resources
+      class WebhookEndpoint < Tito::Resource
+        account_scoped!
+        path_template "webhook_endpoints"
+        resource_name "webhook_endpoint"
+        collection_name "webhook_endpoints"
+        supports :list, :show, :create, :update, :delete
+
+        attribute :id,                 :integer
+        attribute :url,                :string
+        attribute :included_triggers,  :string_array
+        attribute :deprecated,         :boolean
+        attribute :created_at,         :datetime
+        attribute :updated_at,         :datetime
+      end
+    end
+  end
+end

data/lib/tito/admin/scope.rb

@@ -0,0 +1,71 @@
+module Tito
+  module Admin
+    class Scope
+      attr_reader :client, :account, :event, :resource_class, :parent_id
+
+      def initialize(client:, account:, event: nil, resource_class:, parent_id: nil)
+        @client = client
+        @account = account
+        @event = event
+        @resource_class = resource_class
+        @parent_id = parent_id
+        validate!
+      end
+
+      def connection
+        client.connection
+      end
+
+      def collection_path(suffix: nil)
+        base = interpolate(resource_class.path_template)
+        suffix ? "#{base}#{suffix}" : base
+      end
+
+      def member_path(id_or_slug)
+        if resource_class.member_path_template
+          interpolate(resource_class.member_path_template, id_or_slug: id_or_slug)
+        else
+          "#{collection_path}/#{id_or_slug}"
+        end
+      end
+
+      def nested_scope(child_class, parent_id:)
+        self.class.new(
+          client: client,
+          account: account,
+          event: event,
+          resource_class: child_class,
+          parent_id: parent_id
+        )
+      end
+
+      def request(method, path, params: {}, body: {})
+        case method
+        when :get    then connection.get(path, params: params)
+        when :post   then connection.post(path, body: body)
+        when :patch  then connection.patch(path, body: body)
+        when :delete then connection.delete(path)
+        end
+      end
+
+      private
+
+      def interpolate(template, id_or_slug: nil)
+        result = template.dup
+        result.gsub!("%{account}", account.to_s)
+        result.gsub!("%{event}", event.to_s) if event
+        result.gsub!("%{parent_id}", parent_id.to_s) if parent_id
+        result.gsub!("%{id_or_slug}", id_or_slug.to_s) if id_or_slug
+        result
+      end
+
+      def validate!
+        raise Tito::Errors::ConfigurationError, "account is required" unless account
+        if resource_class.event_scoped? && event.nil?
+          raise Tito::Errors::ConfigurationError,
+            "event is required for #{resource_class.resource_name} resources"
+        end
+      end
+    end
+  end
+end

data/lib/tito/configuration.rb

@@ -0,0 +1,9 @@
+module Tito
+  class Configuration
+    attr_accessor :token, :account, :base_url
+
+    def initialize
+      @base_url = "https://api.tito.io/v3"
+    end
+  end
+end

data/lib/tito/connection.rb

@@ -0,0 +1,42 @@
+module Tito
+  class Connection
+    attr_reader :base_url
+
+    def initialize(token:, base_url: nil)
+      @token = token
+      @base_url = base_url || Tito.configuration.base_url
+    end
+
+    def get(path, params: {})
+      handle_response faraday.get(path, params)
+    end
+
+    def post(path, body: {})
+      handle_response faraday.post(path, body)
+    end
+
+    def patch(path, body: {})
+      handle_response faraday.patch(path, body)
+    end
+
+    def delete(path)
+      handle_response faraday.delete(path)
+    end
+
+    def faraday
+      @faraday ||= Faraday.new(url: @base_url) do |f|
+        f.headers["Authorization"] = "Token token=#{@token}"
+        f.headers["Accept"] = "application/json"
+        f.request :json
+        f.response :json, content_type: /\bjson$/
+      end
+    end
+
+    private
+
+    def handle_response(response)
+      return response.body if response.success?
+      raise Tito::Errors.from_response(response)
+    end
+  end
+end

data/lib/tito/errors.rb

@@ -0,0 +1,40 @@
+module Tito
+  module Errors
+    class Error < StandardError; end
+    class ConfigurationError < Error; end
+
+    class ApiError < Error
+      attr_reader :status, :body, :errors
+
+      def initialize(message = nil, status: nil, body: nil)
+        @status = status
+        @body = body
+        @errors = body.is_a?(Hash) ? (body["errors"] || {}) : {}
+        super(message || (body.is_a?(Hash) && body["message"]) || "API error (#{status})")
+      end
+    end
+
+    class UnauthorizedError < ApiError; end  # 401
+    class ForbiddenError    < ApiError; end  # 403
+    class NotFoundError     < ApiError; end  # 404
+    class ValidationError   < ApiError; end  # 422
+    class RateLimitError    < ApiError; end  # 429
+    class ServerError       < ApiError; end  # 5xx
+
+    MAPPING = {
+      401 => UnauthorizedError,
+      403 => ForbiddenError,
+      404 => NotFoundError,
+      422 => ValidationError,
+      429 => RateLimitError
+    }.freeze
+
+    def self.from_response(response)
+      status = response.status
+      body = response.body
+
+      klass = MAPPING[status] || (status >= 500 ? ServerError : ApiError)
+      klass.new(status: status, body: body)
+    end
+  end
+end