pike13 0.1.0.beta → 0.1.1

data/lib/pike13/validators.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+module Pike13
+  # Validation helpers for Pike13 API parameters
+  module Validators
+    class ValidationError < StandardError; end
+
+    # Validates idempotency token format (should be a non-empty string)
+    #
+    # @param token [String] The idempotency token
+    # @raise [ValidationError] if token is invalid
+    # @return [Boolean] true if valid
+    def self.validate_idempotency_token!(token)
+      if token.nil? || token.to_s.strip.empty?
+        raise ValidationError, "Idempotency token cannot be blank"
+      end
+
+      unless token.is_a?(String)
+        raise ValidationError, "Idempotency token must be a string, got #{token.class}"
+      end
+
+      if token.length > 255
+        raise ValidationError, "Idempotency token must be 255 characters or less, got #{token.length}"
+      end
+
+      true
+    end
+
+    # Validates note attributes (must have 'note' key, not 'body')
+    #
+    # @param attributes [Hash] Note attributes
+    # @raise [ValidationError] if attributes are invalid
+    # @return [Boolean] true if valid
+    def self.validate_note_attributes!(attributes)
+      unless attributes.is_a?(Hash)
+        raise ValidationError, "Note attributes must be a hash, got #{attributes.class}"
+      end
+
+      if attributes.key?(:body) || attributes.key?("body")
+        raise ValidationError,
+              "Note attributes should use 'note' key, not 'body'. " \
+              "Example: { note: 'text', subject: 'optional' }"
+      end
+
+      if !attributes.key?(:note) && !attributes.key?("note")
+        raise ValidationError, "Note attributes must include 'note' key"
+      end
+
+      note_value = attributes[:note] || attributes["note"]
+      if note_value.to_s.strip.empty?
+        raise ValidationError, "Note text cannot be blank"
+      end
+
+      true
+    end
+
+    # Validates form of payment type
+    #
+    # @param type [String] Form of payment type
+    # @raise [ValidationError] if type is invalid
+    # @return [Boolean] true if valid
+    def self.validate_form_of_payment_type!(type)
+      valid_types = %w[creditcard ach]
+
+      unless type.is_a?(String)
+        raise ValidationError, "Form of payment type must be a string, got #{type.class}"
+      end
+
+      unless valid_types.include?(type.downcase)
+        raise ValidationError,
+              "Form of payment type must be one of: #{valid_types.join(', ')}. Got: '#{type}'"
+      end
+
+      true
+    end
+
+    # Validates booking parameters
+    #
+    # @param params [Hash] Booking parameters
+    # @raise [ValidationError] if parameters are invalid
+    # @return [Boolean] true if valid
+    def self.validate_booking_params!(params)
+      unless params.is_a?(Hash)
+        raise ValidationError, "Booking parameters must be a hash, got #{params.class}"
+      end
+
+      # Check for idempotency token
+      token = params[:idempotency_token] || params["idempotency_token"]
+      if token
+        validate_idempotency_token!(token)
+      end
+
+      # Require either event_occurrence_id or leases array
+      has_event = params[:event_occurrence_id] || params["event_occurrence_id"]
+      has_leases = params[:leases] || params["leases"]
+
+      unless has_event || has_leases
+        raise ValidationError,
+              "Booking must have either 'event_occurrence_id' or 'leases' parameter"
+      end
+
+      true
+    end
+
+    # Validates person attributes for creation
+    #
+    # @param attributes [Hash] Person attributes
+    # @raise [ValidationError] if attributes are invalid
+    # @return [Boolean] true if valid
+    def self.validate_person_attributes!(attributes)
+      unless attributes.is_a?(Hash)
+        raise ValidationError, "Person attributes must be a hash, got #{attributes.class}"
+      end
+
+      # Check required fields
+      first_name = attributes[:first_name] || attributes["first_name"]
+      last_name = attributes[:last_name] || attributes["last_name"]
+
+      if first_name.to_s.strip.empty?
+        raise ValidationError, "Person must have a first_name"
+      end
+
+      if last_name.to_s.strip.empty?
+        raise ValidationError, "Person must have a last_name"
+      end
+
+      # Validate email format if provided
+      email = attributes[:email] || attributes["email"]
+      if email && !email.to_s.match?(/\A[^@\s]+@[^@\s]+\z/)
+        raise ValidationError, "Invalid email format: #{email}"
+      end
+
+      true
+    end
+  end
+end

data/lib/pike13/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pike13
-  VERSION = "0.1.0.beta"
+  VERSION = "0.1.1"
 end

data/lib/pike13.rb

@@ -4,14 +4,17 @@ require_relative "pike13/version"
 require_relative "pike13/configuration"
 require_relative "pike13/errors"
 require_relative "pike13/http_client"
+require_relative "pike13/http_client_v3"
+require_relative "pike13/validators"
 
 # Namespace base classes
 require_relative "pike13/api/v2/desk/base"
 require_relative "pike13/api/v2/front/base"
 require_relative "pike13/api/v2/account/base"
+require_relative "pike13/api/v3/desk/base"
 
 # Account namespace resources
-require_relative "pike13/api/v2/account/me"
+require_relative "pike13/api/v2/account"
 require_relative "pike13/api/v2/account/business"
 require_relative "pike13/api/v2/account/person"
 require_relative "pike13/api/v2/account/password"
@@ -78,6 +81,20 @@ require_relative "pike13/api/v2/front/visit"
 require_relative "pike13/api/v2/front/waitlist_entry"
 require_relative "pike13/api/v2/front/payment"
 
+# V3 Reporting resources
+require_relative "pike13/api/v3/desk/clients"
+require_relative "pike13/api/v3/desk/enrollments"
+require_relative "pike13/api/v3/desk/event_occurrences"
+require_relative "pike13/api/v3/desk/event_occurrence_staff_members"
+require_relative "pike13/api/v3/desk/invoice_items"
+require_relative "pike13/api/v3/desk/invoice_item_transactions"
+require_relative "pike13/api/v3/desk/invoices"
+require_relative "pike13/api/v3/desk/monthly_business_metrics"
+require_relative "pike13/api/v3/desk/pays"
+require_relative "pike13/api/v3/desk/person_plans"
+require_relative "pike13/api/v3/desk/staff_members"
+require_relative "pike13/api/v3/desk/transactions"
+
 # Pike13 Ruby Client
 #
 # A Ruby gem for interacting with the Pike13 API.
@@ -94,21 +111,22 @@ require_relative "pike13/api/v2/front/payment"
 #
 # @example Using different namespaces
 #   # Account namespace (not scoped to business subdomain)
-#   account = Pike13::API::V2::Account::Me.me
-#   businesses = Pike13::API::V2::Account::Business.all
+#   account = Pike13::Account.me
+#   businesses = Pike13::Account::Business.all
 #
 #   # Desk namespace (staff interface)
-#   people = Pike13::API::V2::Desk::Person.all
-#   events = Pike13::API::V2::Desk::Event.all
+#   people = Pike13::Desk::Person.all
+#   events = Pike13::Desk::Event.all
 #
 #   # Front namespace (client interface)
-#   locations = Pike13::API::V2::Front::Location.all
-#   branding = Pike13::API::V2::Front::Branding.all.first
+#   locations = Pike13::Front::Location.all
+#   branding = Pike13::Front::Branding.all.first
 module Pike13
   # Simplified namespace aliases
   Account = API::V2::Account
   Desk = API::V2::Desk
   Front = API::V2::Front
+  Reporting = API::V3::Desk
 
   class << self
     attr_writer :configuration
@@ -154,6 +172,7 @@ module Pike13
       API::V2::Desk::Base.configure(configuration)
       API::V2::Front::Base.configure(configuration)
       API::V2::Account::Base.configure(configuration)
+      API::V3::Desk::Base.configure(configuration)
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pike13
 version: !ruby/object:Gem::Version
-  version: 0.1.0.beta
+  version: 0.1.1
 platform: ruby
 authors:
 - Juan Huttemann
@@ -23,7 +23,7 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.21'
-description: A Ruby gem for interacting with the Pike13 Core API
+description: A Ruby gem for interacting with the Pike13 API
 email:
 - juanfhuttemann@gmail.com
 executables: []
@@ -34,10 +34,10 @@ files:
 - LICENSE.txt
 - README.md
 - lib/pike13.rb
+- lib/pike13/api/v2/account.rb
 - lib/pike13/api/v2/account/base.rb
 - lib/pike13/api/v2/account/business.rb
 - lib/pike13/api/v2/account/confirmation.rb
-- lib/pike13/api/v2/account/me.rb
 - lib/pike13/api/v2/account/password.rb
 - lib/pike13/api/v2/account/person.rb
 - lib/pike13/api/v2/desk/appointment.rb
@@ -99,9 +99,24 @@ files:
 - lib/pike13/api/v2/front/staff_member.rb
 - lib/pike13/api/v2/front/visit.rb
 - lib/pike13/api/v2/front/waitlist_entry.rb
+- lib/pike13/api/v3/desk/base.rb
+- lib/pike13/api/v3/desk/clients.rb
+- lib/pike13/api/v3/desk/enrollments.rb
+- lib/pike13/api/v3/desk/event_occurrence_staff_members.rb
+- lib/pike13/api/v3/desk/event_occurrences.rb
+- lib/pike13/api/v3/desk/invoice_item_transactions.rb
+- lib/pike13/api/v3/desk/invoice_items.rb
+- lib/pike13/api/v3/desk/invoices.rb
+- lib/pike13/api/v3/desk/monthly_business_metrics.rb
+- lib/pike13/api/v3/desk/pays.rb
+- lib/pike13/api/v3/desk/person_plans.rb
+- lib/pike13/api/v3/desk/staff_members.rb
+- lib/pike13/api/v3/desk/transactions.rb
 - lib/pike13/configuration.rb
 - lib/pike13/errors.rb
 - lib/pike13/http_client.rb
+- lib/pike13/http_client_v3.rb
+- lib/pike13/validators.rb
 - lib/pike13/version.rb
 homepage: https://github.com/juanhuttemann/pike13-ruby
 licenses:
@@ -127,5 +142,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: Ruby client for the Pike13 Core API
+summary: Ruby client for the Pike13 API
 test_files: []

data/lib/pike13/api/v2/account/me.rb

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-module Pike13
-  module API
-    module V2
-      module Account
-        # Account resource for fetching current account details
-        class Me < Base
-          class << self
-            # GET /account
-            # Returns { accounts: [...] }
-            def me
-              client.get("account")
-            end
-          end
-        end
-      end
-    end
-  end
-end