pike13 0.1.0.beta

data/lib/pike13/api/v2/front/form_of_payment.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        class FormOfPayment < Base
+          class << self
+            # GET /front/people/:person_id/form_of_payments
+            def all(person_id:, **params)
+              client.get("front/people/#{person_id}/form_of_payments", params)
+            end
+
+            # GET /front/people/:person_id/form_of_payments/:id
+            def find(person_id:, id:)
+              client.get("front/people/#{person_id}/form_of_payments/#{id}")
+            end
+
+            # GET /front/people/me/form_of_payments/:id
+            def find_me(id:)
+              client.get("front/people/me/form_of_payments/#{id}")
+            end
+
+            # POST /front/people/:person_id/form_of_payments
+            def create(person_id:, attributes:)
+              client.post("front/people/#{person_id}/form_of_payments", { form_of_payment: attributes })
+            end
+
+            # PUT /front/people/:person_id/form_of_payments/:id
+            def update(person_id:, id:, attributes:)
+              client.put("front/people/#{person_id}/form_of_payments/#{id}", { form_of_payment: attributes })
+            end
+
+            # DELETE /front/people/:person_id/form_of_payments/:id
+            def destroy(person_id:, id:)
+              client.delete("front/people/#{person_id}/form_of_payments/#{id}")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/api/v2/front/invoice.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        class Invoice < Base
+          class << self
+            # GET /front/invoices
+            def all
+              client.get("front/invoices")
+            end
+
+            # GET /front/invoices/:id
+            def find(id)
+              client.get("front/invoices/#{id}")
+            end
+
+            # GET /front/invoices/:id/payment_methods
+            def payment_methods(id)
+              client.get("front/invoices/#{id}/payment_methods")
+            end
+
+            # POST /front/invoices
+            def create(attributes)
+              client.post("front/invoices", { invoice: attributes })
+            end
+
+            # PUT /front/invoices/:invoice_id
+            def update(invoice_id, attributes)
+              client.put("front/invoices/#{invoice_id}", { invoice: attributes })
+            end
+
+            # POST /front/invoices/:invoice_id/invoice_items
+            def create_invoice_item(invoice_id, attributes)
+              client.post("front/invoices/#{invoice_id}/invoice_items", { invoice_item: attributes })
+            end
+
+            # DELETE /front/invoices/:invoice_id/invoice_items/:id
+            def destroy_invoice_item(invoice_id, id)
+              client.delete("front/invoices/#{invoice_id}/invoice_items/#{id}")
+            end
+
+            # POST /front/invoices/:invoice_id/payments
+            def create_payment(invoice_id, attributes)
+              client.post("front/invoices/#{invoice_id}/payments", attributes)
+            end
+
+            # DELETE /front/invoices/:invoice_id/payments/:payment_id
+            def destroy_payment(invoice_id, payment_id)
+              client.delete("front/invoices/#{invoice_id}/payments/#{payment_id}")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/api/v2/front/location.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        class Location < Base
+          class << self
+            # GET /front/locations
+            def all
+              client.get("front/locations")
+            end
+
+            # GET /front/locations/:id
+            def find(id)
+              client.get("front/locations/#{id}")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/api/v2/front/note.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        # Notes in Front API are nested under people
+        class Note < Base
+          class << self
+            # GET /front/people/:person_id/notes
+            def all(person_id:)
+              client.get("front/people/#{person_id}/notes")
+            end
+
+            # GET /front/people/:person_id/notes/:id
+            def find(person_id:, id:)
+              client.get("front/people/#{person_id}/notes/#{id}")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/api/v2/front/payment.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        class Payment < Base
+          class << self
+            # GET /front/payments/:id
+            def find(id)
+              client.get("front/payments/#{id}")
+            end
+
+            # GET /front/payments/configuration
+            def configuration
+              client.get("front/payments/configuration")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/api/v2/front/person.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        class Person < Base
+          class << self
+            # GET /front/people/:id
+            def find(id)
+              client.get("front/people/#{id}")
+            end
+
+            # GET /front/people/me
+            def me
+              find(:me)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/api/v2/front/person_plan.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        class PersonPlan < Base
+          class << self
+            # GET /front/people/:person_id/plans
+            def all(person_id:, **params)
+              client.get("front/people/#{person_id}/plans", params)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/api/v2/front/person_visit.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        class PersonVisit < Base
+          class << self
+            # GET /front/people/:person_id/visits
+            def all(person_id:, **params)
+              client.get("front/people/#{person_id}/visits", params)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/api/v2/front/person_waitlist_entry.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        class PersonWaitlistEntry < Base
+          class << self
+            # GET /front/people/:person_id/waitlist_entries
+            def all(person_id:, **params)
+              client.get("front/people/#{person_id}/waitlist_entries", params)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/api/v2/front/person_waiver.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        class PersonWaiver < Base
+          class << self
+            # GET /front/people/:person_id/waivers
+            def all(person_id:, **params)
+              client.get("front/people/#{person_id}/waivers", params)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/api/v2/front/plan.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        class Plan < Base
+          class << self
+            # GET /front/plans
+            def all
+              client.get("front/plans")
+            end
+
+            # GET /front/plans/:id
+            def find(id)
+              client.get("front/plans/#{id}")
+            end
+
+            # GET /front/plans/:id/plan_terms
+            def plan_terms(id)
+              client.get("front/plans/#{id}/plan_terms")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/api/v2/front/plan_product.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        class PlanProduct < Base
+          class << self
+            # GET /front/plan_products
+            def all
+              client.get("front/plan_products")
+            end
+
+            # GET /front/plan_products/:id
+            def find(id)
+              client.get("front/plan_products/#{id}")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/api/v2/front/plan_terms.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        class PlanTerms < Base
+          class << self
+            # GET /front/plans/:plan_id/plan_terms
+            def all(plan_id:, **params)
+              client.get("front/plans/#{plan_id}/plan_terms", params)
+            end
+
+            # GET /front/plans/:plan_id/plan_terms/:plan_terms_id
+            def find(plan_id:, plan_terms_id:)
+              client.get("front/plans/#{plan_id}/plan_terms/#{plan_terms_id}")
+            end
+
+            # GET /front/plans/:plan_id/plan_terms/:plan_terms_id/complete
+            def complete(plan_id:, plan_terms_id:)
+              client.get("front/plans/#{plan_id}/plan_terms/#{plan_terms_id}/complete")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/api/v2/front/service.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        class Service < Base
+          class << self
+            # GET /front/services
+            def all
+              client.get("front/services")
+            end
+
+            # GET /front/services/:id
+            def find(id)
+              client.get("front/services/#{id}")
+            end
+
+            # GET /front/services/:service_id/enrollment_eligibilities
+            def enrollment_eligibilities(service_id:, **params)
+              client.get("front/services/#{service_id}/enrollment_eligibilities", params)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/api/v2/front/staff_member.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        class StaffMember < Base
+          class << self
+            # GET /front/staff_members
+            def all
+              client.get("front/staff_members")
+            end
+
+            # GET /front/staff_members/:id
+            def find(id)
+              client.get("front/staff_members/#{id}")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/api/v2/front/visit.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        class Visit < Base
+          class << self
+            # GET /front/visits
+            def all
+              client.get("front/visits")
+            end
+
+            # GET /front/visits/:id
+            def find(id)
+              client.get("front/visits/#{id}")
+            end
+
+            # POST /front/visits
+            def create(attributes)
+              client.post("front/visits", { visit: attributes })
+            end
+
+            # DELETE /front/visits/:id
+            def destroy(id, **params)
+              client.delete("front/visits/#{id}", params)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/api/v2/front/waitlist_entry.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Pike13
+  module API
+    module V2
+      module Front
+        class WaitlistEntry < Base
+          class << self
+            # GET /front/waitlist_entries
+            def all
+              client.get("front/waitlist_entries")
+            end
+
+            # GET /front/waitlist_entries/:id
+            def find(id)
+              client.get("front/waitlist_entries/#{id}")
+            end
+
+            # POST /front/waitlist_entries
+            def create(attributes)
+              client.post("front/waitlist_entries", { waitlist_entry: attributes })
+            end
+
+            # DELETE /front/waitlist_entries/:id
+            def destroy(id)
+              client.delete("front/waitlist_entries/#{id}")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/pike13/configuration.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Pike13
+  class Configuration
+    attr_accessor :access_token, :base_url
+
+    def initialize
+      @access_token = nil
+      @base_url = "https://pike13.com"
+    end
+
+    # Returns the normalized base URL (adds https:// if missing)
+    # Infers http:// for localhost/.test domains, https:// otherwise
+    #
+    # @return [String]
+    def full_url
+      return base_url if base_url.to_s.start_with?("http://", "https://")
+
+      "#{inferred_scheme}://#{base_url}"
+    end
+
+    # Returns the normalized account base URL
+    # Extracts the domain and port from base_url
+    #
+    # @return [String]
+    def account_full_url
+      # Extract domain from base_url (strip subdomain, keep domain + port)
+      url = base_url.to_s.sub(%r{^https?://}, "")
+
+      # Extract domain and port
+      parts = url.split(".")
+      if parts.length >= 2
+        # Keep last two parts (domain.tld) plus port if exists
+        domain_parts = parts[-2..]
+        domain_with_port = domain_parts.join(".")
+      else
+        # Single part (like localhost), keep as is
+        domain_with_port = url
+      end
+
+      "#{inferred_scheme}://#{domain_with_port}"
+    end
+
+    # Validates the configuration
+    #
+    # @raise [Pike13::ConfigurationError] if configuration is invalid
+    def validate!
+      raise Pike13::ConfigurationError, "access_token is required" unless access_token
+    end
+
+    private
+
+    def inferred_scheme
+      url = base_url.to_s.sub(%r{^https?://}, "")
+      url.start_with?("localhost") || url.include?(".test") ? "http" : "https"
+    end
+  end
+end

data/lib/pike13/errors.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+module Pike13
+  # Base error class for all Pike13 errors
+  class Error < StandardError; end
+
+  # Raised when configuration is invalid or missing
+  #
+  # @example
+  #   Pike13::Client.new  # raises ConfigurationError: "access_token is required"
+  class ConfigurationError < Error; end
+
+  # Base class for all API-related errors
+  # Provides access to HTTP status and response body
+  #
+  # @attr_reader [Integer, nil] http_status HTTP status code from the API
+  # @attr_reader [Hash, String, nil] response_body Response body from the API
+  class APIError < Error
+    attr_reader :http_status, :response_body
+
+    # @param message [String, nil] Error message
+    # @param http_status [Integer, nil] HTTP status code
+    # @param response_body [Hash, String, nil] API response body
+    def initialize(message = nil, http_status: nil, response_body: nil)
+      @http_status = http_status
+      @response_body = response_body
+      super(message)
+    end
+  end
+
+  # Raised when authentication fails (HTTP 401)
+  #
+  # @example
+  #   begin
+  #     client.desk.people.all
+  #   rescue Pike13::AuthenticationError => e
+  #     puts "Invalid access token: #{e.message}"
+  #   end
+  class AuthenticationError < APIError; end
+
+  # Alias for backward compatibility
+  UnauthorizedError = AuthenticationError
+
+  # Raised when rate limit is exceeded (HTTP 429)
+  #
+  # @attr_reader [String, nil] rate_limit_reset Timestamp when rate limit resets
+  #
+  # @example Handle rate limiting
+  #   begin
+  #     client.desk.people.all
+  #   rescue Pike13::RateLimitError => e
+  #     puts "Rate limit exceeded. Resets at: #{e.rate_limit_reset}"
+  #     sleep 60
+  #     retry
+  #   end
+  class RateLimitError < APIError
+    attr_reader :rate_limit_reset
+
+    # @param message [String, nil] Error message
+    # @param http_status [Integer, nil] HTTP status code
+    # @param response_body [Hash, String, nil] API response body
+    # @param rate_limit_reset [String, nil] Timestamp when rate limit resets
+    def initialize(message = nil, http_status: nil, response_body: nil, rate_limit_reset: nil)
+      @rate_limit_reset = rate_limit_reset
+      super(message, http_status: http_status, response_body: response_body)
+    end
+  end
+
+  # Raised when a resource is not found (HTTP 404)
+  #
+  # @example
+  #   begin
+  #     person = client.desk.people.find(999999)
+  #   rescue Pike13::NotFoundError => e
+  #     puts "Person not found"
+  #   end
+  class NotFoundError < APIError; end
+
+  # Raised when validation fails (HTTP 422)
+  #
+  # @example
+  #   begin
+  #     # attempt to create/update with invalid data
+  #   rescue Pike13::ValidationError => e
+  #     puts "Validation failed: #{e.response_body}"
+  #   end
+  class ValidationError < APIError; end
+
+  # Raised when server error occurs (HTTP 5xx)
+  #
+  # @example
+  #   begin
+  #     client.desk.people.all
+  #   rescue Pike13::ServerError => e
+  #     puts "Server error: #{e.http_status}"
+  #   end
+  class ServerError < APIError; end
+
+  # Raised when request is malformed (HTTP 400)
+  class BadRequestError < APIError; end
+
+  # Raised when connection to API fails
+  class ConnectionError < Error; end
+end