pike13 0.1.0.beta

data/lib/pike13/http_client.rb

@@ -0,0 +1,175 @@
+# frozen_string_literal: true
+
+require "httparty"
+
+module Pike13
+  # HTTParty-based HTTP client for Pike13 API
+  # Provides  HTTP methods with error handling
+  class HTTPClient
+    include HTTParty
+
+    attr_reader :base_url, :access_token
+
+    def initialize(base_url:, access_token:)
+      @base_url = base_url
+      @access_token = access_token
+    end
+
+    # GET request
+    #
+    # @param path [String] The API endpoint path
+    # @param params [Hash] Query parameters
+    # @return [Hash, Array] Parsed response body
+    def get(path, params = {})
+      handle_response do
+        self.class.get(
+          full_path(path),
+          query: params,
+          headers: headers,
+          timeout: 30
+        )
+      end
+    end
+
+    # POST request
+    #
+    # @param path [String] The API endpoint path
+    # @param body [Hash] Request body
+    # @param params [Hash] Query parameters
+    # @return [Hash] Parsed response body
+    def post(path, body = {}, params = {})
+      handle_response do
+        self.class.post(
+          full_path(path),
+          body: body.to_json,
+          query: params,
+          headers: headers,
+          timeout: 30
+        )
+      end
+    end
+
+    # PUT request
+    #
+    # @param path [String] The API endpoint path
+    # @param body [Hash] Request body
+    # @param params [Hash] Query parameters
+    # @return [Hash] Parsed response body
+    def put(path, body = {}, params = {})
+      handle_response do
+        self.class.put(
+          full_path(path),
+          body: body.to_json,
+          query: params,
+          headers: headers,
+          timeout: 30
+        )
+      end
+    end
+
+    # PATCH request
+    #
+    # @param path [String] The API endpoint path
+    # @param body [Hash] Request body
+    # @param params [Hash] Query parameters
+    # @return [Hash] Parsed response body
+    def patch(path, body = {}, params = {})
+      handle_response do
+        self.class.patch(
+          full_path(path),
+          body: body.to_json,
+          query: params,
+          headers: headers,
+          timeout: 30
+        )
+      end
+    end
+
+    # DELETE request
+    #
+    # @param path [String] The API endpoint path
+    # @param params [Hash] Query parameters
+    # @return [Hash] Parsed response body
+    def delete(path, params = {})
+      handle_response do
+        self.class.delete(
+          full_path(path),
+          query: params,
+          headers: headers,
+          timeout: 30
+        )
+      end
+    end
+
+    private
+
+    def full_path(path)
+      "#{base_url}/api/v2/#{path}"
+    end
+
+    def headers
+      {
+        "Authorization" => "Bearer #{access_token}",
+        "Content-Type" => "application/json",
+        "Accept" => "application/json"
+      }
+    end
+
+    def handle_response
+      response = yield
+      handle_status_code(response)
+    rescue HTTParty::Error => e
+      raise Pike13::ConnectionError, "Connection failed: #{e.message}"
+    end
+
+    def handle_status_code(response)
+      return parse_response_body(response) if response.code.between?(200, 299)
+
+      raise_error_for_status(response)
+    end
+
+    def raise_error_for_status(response)
+      case response.code
+      when 400 then raise Pike13::BadRequestError.new(response.body, http_status: response.code)
+      when 401 then raise Pike13::UnauthorizedError.new("Unauthorized", http_status: response.code)
+      when 404 then raise Pike13::NotFoundError.new("Resource not found", http_status: response.code)
+      when 422 then raise_validation_error(response)
+      when 429 then raise Pike13::RateLimitError.new("Rate limit exceeded", http_status: response.code)
+      when 500..599 then raise Pike13::ServerError.new("Server error", http_status: response.code)
+      else raise Pike13::APIError.new("Unexpected error", http_status: response.code)
+      end
+    end
+
+    def raise_validation_error(response)
+      parsed = parse_json_safely(response.body)
+      error_message = extract_error_message(parsed, response.body)
+      raise Pike13::ValidationError.new(error_message, http_status: response.code)
+    end
+
+    def parse_json_safely(body)
+      JSON.parse(body)
+    rescue StandardError
+      {}
+    end
+
+    def extract_error_message(parsed, fallback)
+      return fallback unless parsed.is_a?(Hash) && parsed["errors"]
+
+      parsed["errors"].is_a?(Array) ? parsed["errors"].first : parsed["errors"]
+    end
+
+    def parse_response_body(response)
+      return nil if response.body.nil? || response.body.empty?
+
+      parsed = response.parsed_response
+      return parsed unless parsed.is_a?(Hash)
+
+      # Handle different response formats
+      if parsed.key?("data")
+        parsed["data"]
+      else
+        parsed
+      end
+    end
+  end
+end

data/lib/pike13/version.rb

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

data/lib/pike13.rb

@@ -0,0 +1,159 @@
+# frozen_string_literal: true
+
+require_relative "pike13/version"
+require_relative "pike13/configuration"
+require_relative "pike13/errors"
+require_relative "pike13/http_client"
+
+# Namespace base classes
+require_relative "pike13/api/v2/desk/base"
+require_relative "pike13/api/v2/front/base"
+require_relative "pike13/api/v2/account/base"
+
+# Account namespace resources
+require_relative "pike13/api/v2/account/me"
+require_relative "pike13/api/v2/account/business"
+require_relative "pike13/api/v2/account/person"
+require_relative "pike13/api/v2/account/password"
+require_relative "pike13/api/v2/account/confirmation"
+
+# Desk resources
+require_relative "pike13/api/v2/desk/appointment"
+require_relative "pike13/api/v2/desk/booking"
+require_relative "pike13/api/v2/desk/business"
+require_relative "pike13/api/v2/desk/custom_field"
+require_relative "pike13/api/v2/desk/event"
+require_relative "pike13/api/v2/desk/event_occurrence"
+require_relative "pike13/api/v2/desk/event_occurrence_note"
+require_relative "pike13/api/v2/desk/event_occurrence_visit"
+require_relative "pike13/api/v2/desk/event_occurrence_waitlist_entry"
+require_relative "pike13/api/v2/desk/form_of_payment"
+require_relative "pike13/api/v2/desk/invoice"
+require_relative "pike13/api/v2/desk/location"
+require_relative "pike13/api/v2/desk/note"
+require_relative "pike13/api/v2/desk/pack"
+require_relative "pike13/api/v2/desk/pack_product"
+require_relative "pike13/api/v2/desk/person"
+require_relative "pike13/api/v2/desk/person_plan"
+require_relative "pike13/api/v2/desk/person_visit"
+require_relative "pike13/api/v2/desk/person_waitlist_entry"
+require_relative "pike13/api/v2/desk/person_waiver"
+require_relative "pike13/api/v2/desk/plan"
+require_relative "pike13/api/v2/desk/plan_product"
+require_relative "pike13/api/v2/desk/punch"
+require_relative "pike13/api/v2/desk/revenue_category"
+require_relative "pike13/api/v2/desk/sales_tax"
+require_relative "pike13/api/v2/desk/service"
+require_relative "pike13/api/v2/desk/staff_member"
+require_relative "pike13/api/v2/desk/visit"
+require_relative "pike13/api/v2/desk/waitlist_entry"
+require_relative "pike13/api/v2/desk/payment"
+require_relative "pike13/api/v2/desk/refund"
+require_relative "pike13/api/v2/desk/make_up"
+
+# Front resources
+require_relative "pike13/api/v2/front/appointment"
+require_relative "pike13/api/v2/front/booking"
+require_relative "pike13/api/v2/front/branding"
+require_relative "pike13/api/v2/front/business"
+require_relative "pike13/api/v2/front/event"
+require_relative "pike13/api/v2/front/event_occurrence"
+require_relative "pike13/api/v2/front/event_occurrence_note"
+require_relative "pike13/api/v2/front/event_occurrence_waitlist_eligibility"
+require_relative "pike13/api/v2/front/form_of_payment"
+require_relative "pike13/api/v2/front/invoice"
+require_relative "pike13/api/v2/front/location"
+require_relative "pike13/api/v2/front/note"
+require_relative "pike13/api/v2/front/person"
+require_relative "pike13/api/v2/front/person_plan"
+require_relative "pike13/api/v2/front/person_visit"
+require_relative "pike13/api/v2/front/person_waitlist_entry"
+require_relative "pike13/api/v2/front/person_waiver"
+require_relative "pike13/api/v2/front/plan"
+require_relative "pike13/api/v2/front/plan_product"
+require_relative "pike13/api/v2/front/plan_terms"
+require_relative "pike13/api/v2/front/service"
+require_relative "pike13/api/v2/front/staff_member"
+require_relative "pike13/api/v2/front/visit"
+require_relative "pike13/api/v2/front/waitlist_entry"
+require_relative "pike13/api/v2/front/payment"
+
+# Pike13 Ruby Client
+#
+# A Ruby gem for interacting with the Pike13 API.
+#
+# @example Configuration
+#   Pike13.configure do |config|
+#     config.access_token = "your_access_token"
+#     config.base_url = "mybusiness.pike13.com"
+#   end
+#
+#   # Then use models directly
+#   person = Pike13::API::V2::Desk::Person.find(123)
+#   people = Pike13::API::V2::Desk::Person.all
+#
+# @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
+#
+#   # Desk namespace (staff interface)
+#   people = Pike13::API::V2::Desk::Person.all
+#   events = Pike13::API::V2::Desk::Event.all
+#
+#   # Front namespace (client interface)
+#   locations = Pike13::API::V2::Front::Location.all
+#   branding = Pike13::API::V2::Front::Branding.all.first
+module Pike13
+  # Simplified namespace aliases
+  Account = API::V2::Account
+  Desk = API::V2::Desk
+  Front = API::V2::Front
+
+  class << self
+    attr_writer :configuration
+
+    # Returns the global configuration object
+    #
+    # @return [Configuration]
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    # Configure Pike13 globally
+    #
+    # Automatically applies configuration to all API Base classes.
+    #
+    # @yield [Configuration] Global configuration object
+    #
+    # @example
+    #   Pike13.configure do |config|
+    #     config.access_token = "your_access_token"
+    #     config.base_url = "mybusiness.pike13.com"
+    #   end
+    #
+    #   # Then use models directly
+    #   person = Pike13::API::V2::Desk::Person.find(123)
+    def configure
+      yield(configuration)
+      configuration.validate!
+      apply_configuration!
+    end
+
+    # Reset configuration (mainly for testing)
+    #
+    # @return [Configuration] New configuration object
+    def reset!
+      @configuration = Configuration.new
+    end
+
+    private
+
+    # Apply configuration to all API Base classes
+    def apply_configuration!
+      API::V2::Desk::Base.configure(configuration)
+      API::V2::Front::Base.configure(configuration)
+      API::V2::Account::Base.configure(configuration)
+    end
+  end
+end

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification
+name: pike13
+version: !ruby/object:Gem::Version
+  version: 0.1.0.beta
+platform: ruby
+authors:
+- Juan Huttemann
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.21'
+description: A Ruby gem for interacting with the Pike13 Core API
+email:
+- juanfhuttemann@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- lib/pike13.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
+- lib/pike13/api/v2/desk/base.rb
+- lib/pike13/api/v2/desk/booking.rb
+- lib/pike13/api/v2/desk/business.rb
+- lib/pike13/api/v2/desk/custom_field.rb
+- lib/pike13/api/v2/desk/event.rb
+- lib/pike13/api/v2/desk/event_occurrence.rb
+- lib/pike13/api/v2/desk/event_occurrence_note.rb
+- lib/pike13/api/v2/desk/event_occurrence_visit.rb
+- lib/pike13/api/v2/desk/event_occurrence_waitlist_entry.rb
+- lib/pike13/api/v2/desk/form_of_payment.rb
+- lib/pike13/api/v2/desk/invoice.rb
+- lib/pike13/api/v2/desk/location.rb
+- lib/pike13/api/v2/desk/make_up.rb
+- lib/pike13/api/v2/desk/note.rb
+- lib/pike13/api/v2/desk/pack.rb
+- lib/pike13/api/v2/desk/pack_product.rb
+- lib/pike13/api/v2/desk/payment.rb
+- lib/pike13/api/v2/desk/person.rb
+- lib/pike13/api/v2/desk/person_plan.rb
+- lib/pike13/api/v2/desk/person_visit.rb
+- lib/pike13/api/v2/desk/person_waitlist_entry.rb
+- lib/pike13/api/v2/desk/person_waiver.rb
+- lib/pike13/api/v2/desk/plan.rb
+- lib/pike13/api/v2/desk/plan_product.rb
+- lib/pike13/api/v2/desk/punch.rb
+- lib/pike13/api/v2/desk/refund.rb
+- lib/pike13/api/v2/desk/revenue_category.rb
+- lib/pike13/api/v2/desk/sales_tax.rb
+- lib/pike13/api/v2/desk/service.rb
+- lib/pike13/api/v2/desk/staff_member.rb
+- lib/pike13/api/v2/desk/visit.rb
+- lib/pike13/api/v2/desk/waitlist_entry.rb
+- lib/pike13/api/v2/front/appointment.rb
+- lib/pike13/api/v2/front/base.rb
+- lib/pike13/api/v2/front/booking.rb
+- lib/pike13/api/v2/front/branding.rb
+- lib/pike13/api/v2/front/business.rb
+- lib/pike13/api/v2/front/event.rb
+- lib/pike13/api/v2/front/event_occurrence.rb
+- lib/pike13/api/v2/front/event_occurrence_note.rb
+- lib/pike13/api/v2/front/event_occurrence_waitlist_eligibility.rb
+- lib/pike13/api/v2/front/form_of_payment.rb
+- lib/pike13/api/v2/front/invoice.rb
+- lib/pike13/api/v2/front/location.rb
+- lib/pike13/api/v2/front/note.rb
+- lib/pike13/api/v2/front/payment.rb
+- lib/pike13/api/v2/front/person.rb
+- lib/pike13/api/v2/front/person_plan.rb
+- lib/pike13/api/v2/front/person_visit.rb
+- lib/pike13/api/v2/front/person_waitlist_entry.rb
+- lib/pike13/api/v2/front/person_waiver.rb
+- lib/pike13/api/v2/front/plan.rb
+- lib/pike13/api/v2/front/plan_product.rb
+- lib/pike13/api/v2/front/plan_terms.rb
+- lib/pike13/api/v2/front/service.rb
+- 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/configuration.rb
+- lib/pike13/errors.rb
+- lib/pike13/http_client.rb
+- lib/pike13/version.rb
+homepage: https://github.com/juanhuttemann/pike13-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/juanhuttemann/pike13-ruby
+  source_code_uri: https://github.com/juanhuttemann/pike13-ruby
+  changelog_uri: https://github.com/juanhuttemann/pike13-ruby/blob/master/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Ruby client for the Pike13 Core API
+test_files: []