tito_ruby 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 12e525061a6eb7a57d6d38ded7e37484ad4bf99cff3bc6dbb3b255667485aa98
+  data.tar.gz: 52be4e37d656838e821b668ee49344e6e1e9839b0106c89d294eb39dd4c7985c
+SHA512:
+  metadata.gz: bd789d6806949407ec212d36ddf8950a9d53ec9d7ffc5ae995759d0bc905aac16df6ce2a55c0d535c469a552f903527c07a3634a50c74cdc6844c48089d78d8c
+  data.tar.gz: 304f031d911a74b35e411c1cea57f6abc9496697945f0026cae8ed741f013c8e807bad7c9546f4a8332cd0a715201cf281d85122108553a42f9b77a222598590

data/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## 0.1.0 (Unreleased)
+
+**WARNING:** This is pre-release, mostly-Claude-code-generated, mostly-untested software. It mostly doesn't work at all. Only the Tickets resource is known even to successfully load data. Use at your own risk.
+
+- Initial release
+- Admin API client with token-based authentication
+- Support for 18 resource types: Events, Releases, Tickets, Registrations, Activities, Questions, Answers, Discount Codes, Checkin Lists, Opt-Ins, Interested Users, RSVP Lists, Release Invitations, Waitlisted People, Webhook Endpoints, Refunds, Venues
+- Chainable query builder with search, filtering, ordering, pagination, and field expansion
+- ActiveModel-backed resources with dirty tracking
+- Lazy-loaded, paginated collections

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,119 @@
+# Tito Ruby
+
+A Ruby client for the [Tito](https://ti.to) Admin API v3.
+
+**WARNING:** This is pre-release, mostly-Claude-code-generated, mostly-untested software. It mostly doesn't work at all. Only the Tickets resource is known even to successfully load data. Use at your own risk.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "tito_ruby"
+```
+
+Or install directly:
+
+```
+gem install tito_ruby
+```
+
+## Configuration
+
+```ruby
+Tito.configure do |config|
+  config.token   = "your_api_token"
+  config.account = "your_account_slug"
+end
+```
+
+Or pass credentials directly to the client:
+
+```ruby
+client = Tito::Admin::Client.new(token: "your_api_token", account: "your_account_slug")
+```
+
+## Usage
+
+### Events
+
+```ruby
+client = Tito::Admin::Client.new
+
+# List events
+client.events.each { |event| puts event.title }
+
+# Find a specific event
+event = client.events.find("my-event-slug")
+
+# Past and archived events
+client.past_events.each { |e| puts e.title }
+client.archived_events.each { |e| puts e.title }
+```
+
+### Tickets
+
+```ruby
+client = Tito::Admin::Client.new(event: "my-event")
+
+# List tickets
+client.tickets.each { |ticket| puts ticket.reference }
+
+# Search and filter
+client.tickets.search("john").each { |t| puts t.reference }
+
+# Pagination
+client.tickets.page(2).per(50).each { |t| puts t.reference }
+```
+
+### Registrations
+
+```ruby
+client.registrations.each { |reg| puts reg.name }
+```
+
+### Releases
+
+```ruby
+client.releases.each { |release| puts release.title }
+```
+
+### Discount Codes
+
+```ruby
+client.discount_codes.each { |code| puts code.code }
+```
+
+### Query Builder
+
+All collections support a chainable query interface:
+
+```ruby
+client.tickets
+  .where(state: "complete")
+  .order("created_at_desc")
+  .expand("registration", "release")
+  .page(1)
+  .per(25)
+  .each { |t| puts t.reference }
+```
+
+### Available Resources
+
+- Events, Releases, Tickets, Registrations
+- Activities, Questions, Answers
+- Discount Codes, Checkin Lists
+- Opt-Ins, Interested Users, RSVP Lists
+- Release Invitations, Waitlisted People
+- Webhook Endpoints, Refunds, Venues
+
+## Development
+
+```
+bundle install
+bundle exec rake test
+```
+
+## License
+
+MIT License. See [LICENSE.txt](LICENSE.txt).

data/lib/tito/admin/client.rb

@@ -0,0 +1,98 @@
+module Tito
+  module Admin
+    class Client
+      attr_reader :token, :account, :event, :connection
+
+      def initialize(token: nil, account: nil, event: nil)
+        @token   = token   || Tito.configuration.token
+        @account = account || Tito.configuration.account
+        @event   = event
+
+        raise Tito::Errors::ConfigurationError, "token is required" unless @token
+        raise Tito::Errors::ConfigurationError, "account is required" unless @account
+
+        @connection = Tito::Connection.new(token: @token)
+      end
+
+      # -- Account-scoped resources --
+
+      def events
+        collection_for(Resources::Event)
+      end
+
+      def past_events
+        collection_for(Resources::Event, path_suffix: "/past")
+      end
+
+      def archived_events
+        collection_for(Resources::Event, path_suffix: "/archived")
+      end
+
+      def webhook_endpoints
+        collection_for(Resources::WebhookEndpoint)
+      end
+
+      # -- Event-scoped resources --
+
+      def tickets(event: self.event)
+        collection_for(Resources::Ticket, event: event)
+      end
+
+      def releases(event: self.event)
+        collection_for(Resources::Release, event: event)
+      end
+
+      def registrations(event: self.event)
+        collection_for(Resources::Registration, event: event)
+      end
+
+      def activities(event: self.event)
+        collection_for(Resources::Activity, event: event)
+      end
+
+      def questions(event: self.event)
+        collection_for(Resources::Question, event: event)
+      end
+
+      def discount_codes(event: self.event)
+        collection_for(Resources::DiscountCode, event: event)
+      end
+
+      def checkin_lists(event: self.event)
+        collection_for(Resources::CheckinList, event: event)
+      end
+
+      def opt_ins(event: self.event)
+        collection_for(Resources::OptIn, event: event)
+      end
+
+      def interested_users(event: self.event)
+        collection_for(Resources::InterestedUser, event: event)
+      end
+
+      def rsvp_lists(event: self.event)
+        collection_for(Resources::RsvpList, event: event)
+      end
+
+      def waitlisted_people(event: self.event)
+        collection_for(Resources::WaitlistedPerson, event: event)
+      end
+
+      def venues(event: self.event)
+        collection_for(Resources::Venue, event: event)
+      end
+
+      private
+
+      def collection_for(resource_class, event: nil, path_suffix: nil)
+        scope = Scope.new(
+          client: self,
+          account: @account,
+          event: event,
+          resource_class: resource_class
+        )
+        CollectionProxy.new(scope: scope, path_suffix: path_suffix)
+      end
+    end
+  end
+end

data/lib/tito/admin/collection_proxy.rb

@@ -0,0 +1,119 @@
+module Tito
+  module Admin
+    class CollectionProxy
+      include Enumerable
+
+      def initialize(scope:, path_suffix: nil)
+        @scope = scope
+        @path_suffix = path_suffix
+        @query = QueryBuilder.new
+        @loaded_pages = {}
+        @meta = nil
+      end
+
+      # -- Chainable query methods (return new proxy) --
+
+      def where(**conditions)
+        dup_with { |q| q.add_where(conditions) }
+      end
+
+      def order(**fields)
+        dup_with { |q| q.add_order(fields) }
+      end
+
+      def search(term)
+        dup_with { |q| q.add_search(term) }
+      end
+
+      def expand(*fields)
+        dup_with { |q| q.add_expand(fields) }
+      end
+
+      def page(number)
+        dup_with { |q| q.set_page(number) }
+      end
+
+      def per(size)
+        dup_with { |q| q.set_per_page(size) }
+      end
+
+      # -- Reading --
+
+      def find(id_or_slug)
+        params = @query.expand_params
+        data = @scope.request(:get, @scope.member_path(id_or_slug), params: params)
+        instantiate(data[@scope.resource_class.resource_name] || data)
+      end
+
+      def each(&block)
+        return enum_for(:each) unless block_given?
+
+        page_number = @query.page_number || 1
+        loop do
+          page_data = fetch_page(page_number)
+          records = page_data[@scope.resource_class.collection_name] || []
+          records.each { |attrs| block.call(instantiate(attrs)) }
+
+          meta = page_data["meta"] || {}
+          break if meta["next_page"].nil?
+          page_number = meta["next_page"]
+        end
+      end
+
+      def size
+        ensure_first_page_loaded
+        @meta&.fetch("total_count", 0) || 0
+      end
+      alias_method :count, :size
+      alias_method :length, :size
+
+      def total_pages
+        ensure_first_page_loaded
+        @meta&.fetch("total_pages", 0) || 0
+      end
+
+      def empty?
+        size == 0
+      end
+
+      # -- Mutation helpers --
+
+      def build(**attrs)
+        @scope.resource_class.new(_scope: @scope, **attrs)
+      end
+
+      def create(**attrs)
+        build(**attrs).tap(&:save)
+      end
+
+      private
+
+      def dup_with
+        dup.tap do |copy|
+          new_query = @query.dup
+          yield new_query
+          copy.instance_variable_set(:@query, new_query)
+          copy.instance_variable_set(:@loaded_pages, {})
+          copy.instance_variable_set(:@meta, nil)
+        end
+      end
+
+      def fetch_page(number)
+        @loaded_pages[number] ||= begin
+          params = @query.to_params.merge("page[number]" => number)
+          data = @scope.request(:get, @scope.collection_path(suffix: @path_suffix), params: params)
+          @meta = data["meta"] if data.is_a?(Hash)
+          data
+        end
+      end
+
+      def ensure_first_page_loaded
+        fetch_page(@query.page_number || 1) unless @meta
+      end
+
+      def instantiate(attrs)
+        @scope.resource_class.new(_scope: @scope, **attrs.transform_keys(&:to_sym))
+      end
+    end
+  end
+end

data/lib/tito/admin/query_builder.rb

@@ -0,0 +1,110 @@
+module Tito
+  module Admin
+    class QueryBuilder
+      attr_reader :page_number
+
+      def initialize
+        @wheres = {}
+        @orders = {}
+        @search_term = nil
+        @expands = []
+        @page_number = nil
+        @per_page = nil
+      end
+
+      def add_where(conditions)
+        conditions.each { |key, value| @wheres[key] = value }
+        self
+      end
+
+      def add_order(fields)
+        @orders.merge!(fields)
+        self
+      end
+
+      def add_search(term)
+        @search_term = term
+        self
+      end
+
+      def add_expand(fields)
+        @expands.concat(fields.flatten)
+        self
+      end
+
+      def set_page(number)
+        @page_number = number
+        self
+      end
+
+      def set_per_page(size)
+        @per_page = size
+        self
+      end
+
+      def expand_params
+        @expands.any? ? { "expand" => @expands.join(",") } : {}
+      end
+
+      def to_params
+        params = {}
+        params["page[size]"] = @per_page if @per_page
+        params["q"] = @search_term if @search_term
+        params.merge!(expand_params)
+        params.merge!(where_params)
+        params.merge!(order_params)
+        params
+      end
+
+      def dup
+        super.tap do |copy|
+          copy.instance_variable_set(:@wheres, @wheres.dup)
+          copy.instance_variable_set(:@orders, @orders.dup)
+          copy.instance_variable_set(:@expands, @expands.dup)
+        end
+      end
+
+      private
+
+      def where_params
+        params = {}
+        @wheres.each do |key, value|
+          case value
+          when Array
+            plural_key = key.to_s
+            plural_key = plural_key.end_with?("s") ? plural_key : "#{plural_key}s"
+            params["search[#{plural_key}][]"] = value.map(&:to_s)
+          when Range
+            if value.begin
+              params["search[#{key}][gte]"] = format_value(value.begin)
+            end
+            if value.end
+              op = value.exclude_end? ? "lt" : "lte"
+              params["search[#{key}][#{op}]"] = format_value(value.end)
+            end
+          else
+            params["search[#{key}]"] = format_value(value)
+          end
+        end
+        params
+      end
+
+      def order_params
+        return {} if @orders.empty?
+        parts = @orders.map { |field, dir| dir == :desc ? "-#{field}" : field.to_s }
+        { "sort" => parts.join(",") }
+      end
+
+      def format_value(val)
+        case val
+        when Time, DateTime
+          val.utc.iso8601.sub(/Z$/, " UTC")
+        when Date
+          val.to_s
+        else
+          val.to_s
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,32 @@
+module Tito
+  module Admin
+    module Resources
+      class Activity < Tito::Resource
+        event_scoped!
+        path_template "%{account}/%{event}/activities"
+        resource_name "activity"
+        collection_name "activities"
+        supports :list, :show, :create, :update, :delete
+
+        attribute :id,               :integer
+        attribute :name,             :string
+        attribute :description,      :string
+        attribute :date,             :string
+        attribute :start_time,       :string
+        attribute :end_time,         :string
+        attribute :start_at,         :datetime
+        attribute :end_at,           :datetime
+        attribute :capacity,         :integer
+        attribute :allocation_count, :integer
+        attribute :sold_out,         :boolean
+        attribute :show_to_attendee, :boolean
+        attribute :created_at,       :datetime
+        attribute :updated_at,       :datetime
+
+        expandable :questions, :releases, :upgrades, :venue
+
+        action :duplicate, method: :post, path: "duplication"
+      end
+    end
+  end
+end

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

@@ -0,0 +1,23 @@
+module Tito
+  module Admin
+    module Resources
+      class Answer < Tito::Resource
+        event_scoped!
+        path_template "%{account}/%{event}/questions/%{parent_id}/answers"
+        resource_name "answer"
+        collection_name "answers"
+        supports :list, :show
+
+        attribute :id,                 :integer
+        attribute :question_id,        :integer
+        attribute :ticket_id,          :integer
+        attribute :primary_response,   :string
+        attribute :alternate_response, :string
+        attribute :response,           :string
+        attribute :download_url,       :string
+
+        expandable :question, :ticket
+      end
+    end
+  end
+end

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

@@ -0,0 +1,34 @@
+module Tito
+  module Admin
+    module Resources
+      class CheckinList < Tito::Resource
+        event_scoped!
+        path_template "%{account}/%{event}/checkin_lists"
+        resource_name "checkin_list"
+        collection_name "checkin_lists"
+        supports :list, :show, :create, :update, :delete
+
+        attribute :id,                  :integer
+        attribute :slug,                :string
+        attribute :title,               :string
+        attribute :web_checkin_url,     :string
+        attribute :qr_code_url,        :string
+        attribute :expires_at,          :datetime
+        attribute :expired,             :boolean
+        attribute :open,                :boolean
+        attribute :state,               :string
+        attribute :show_email,          :boolean
+        attribute :show_company_name,   :boolean
+        attribute :show_phone_number,   :boolean
+        attribute :hide_unpaid,         :boolean
+        attribute :checked_in_count,    :integer
+        attribute :checked_in_percent,  :decimal
+        attribute :tickets_count,       :integer
+        attribute :created_at,          :datetime
+        attribute :updated_at,          :datetime
+
+        expandable :activities, :questions, :releases
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+module Tito
+  module Admin
+    module Resources
+      class DiscountCode < Tito::Resource
+        event_scoped!
+        path_template "%{account}/%{event}/discount_codes"
+        resource_name "discount_code"
+        collection_name "discount_codes"
+        supports :list, :show, :create, :update, :delete
+
+        attribute :id,                                    :integer
+        attribute :code,                                  :string
+        attribute :state,                                 :string
+        attribute :type,                                  :string
+        attribute :value,                                 :decimal
+        attribute :start_at,                              :datetime
+        attribute :end_at,                                :datetime
+        attribute :quantity,                              :integer
+        attribute :quantity_used,                         :integer
+        attribute :min_quantity_per_release,              :integer
+        attribute :max_quantity_per_release,              :integer
+        attribute :registrations_count,                   :integer
+        attribute :tickets_count,                         :integer
+        attribute :share_url,                             :string
+        attribute :description,                           :string
+        attribute :description_for_organizer,             :string
+        attribute :show_public_releases,                  :boolean
+        attribute :show_secret_releases,                  :boolean
+        attribute :block_registrations_if_not_applicable, :boolean
+        attribute :disable_for_degressive,                :boolean
+        attribute :created_at,                            :datetime
+        attribute :updated_at,                            :datetime
+      end
+    end
+  end
+end

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

@@ -0,0 +1,62 @@
+module Tito
+  module Admin
+    module Resources
+      class Event < Tito::Resource
+        account_scoped!
+        path_template "events"
+        member_path_template "%{account}/%{id_or_slug}"
+        resource_name "event"
+        collection_name "events"
+        supports :list, :show, :create, :update, :delete
+
+        attribute :id,                      :integer
+        attribute :slug,                    :string
+        attribute :title,                   :string
+        attribute :url,                     :string
+        attribute :account_id,              :integer
+        attribute :account_slug,            :string
+        attribute :currency,                :string
+        attribute :email_address,           :string
+        attribute :description,             :string
+
+        attribute :start_date,              :string
+        attribute :start_time,              :string
+        attribute :end_date,                :string
+        attribute :end_time,                :string
+        attribute :timezone,                :string
+
+        attribute :live,                    :boolean
+        attribute :private,                 :boolean
+        attribute :archived,                :boolean
+        attribute :test_mode,               :boolean
+        attribute :setup,                   :boolean
+
+        attribute :tickets_count,           :integer
+        attribute :registrations_count,     :integer
+        attribute :releases_count,          :integer
+
+        attribute :show_banner,             :boolean
+        attribute :show_logo,               :boolean
+        attribute :show_title,              :boolean
+        attribute :show_prices_ex_tax,      :boolean
+
+        attribute :require_billing_address, :boolean
+        attribute :require_company_name,    :boolean
+        attribute :require_vat_number,      :boolean
+
+        attribute :max_tickets_per_person,  :integer
+        attribute :min_tickets_per_person,  :integer
+
+        attribute :security_token,          :string
+        attribute :metadata,                :string
+
+        attribute :created_at,              :datetime
+        attribute :updated_at,              :datetime
+
+        expandable :releases, :release_ids, :release_slugs, :paypal_payment_options, :currency_options
+
+        action :duplicate, method: :post, path: "duplication"
+      end
+    end
+  end
+end