astroapi-ruby 1.0.0

data/lib/astroapi/http/client.rb

@@ -0,0 +1,108 @@
+# frozen_string_literal: true
+
+require 'faraday'
+require 'faraday/retry'
+require_relative 'middleware/authentication'
+require_relative 'middleware/response_unwrapper'
+require_relative 'middleware/logger'
+
+module Astroapi
+  module HTTP
+    # HTTP client wrapper using Faraday
+    class Client
+      attr_reader :config
+
+      def initialize(config)
+        @config = config
+        @connection = build_connection
+      end
+
+      # Make a GET request
+      # @param path [String] Request path
+      # @param params [Hash] Query parameters
+      # @return [Hash] Response body
+      def get(path, params: {})
+        response = @connection.get(path, params)
+        response.body
+      rescue Faraday::Error => e
+        raise Astroapi::Error.from_faraday_error(e)
+      end
+
+      # Make a POST request
+      # @param path [String] Request path
+      # @param body [Hash] Request body
+      # @return [Hash] Response body
+      def post(path, body: {})
+        response = @connection.post(path) do |req|
+          req.body = body.to_json
+        end
+        response.body
+      rescue Faraday::Error => e
+        raise Astroapi::Error.from_faraday_error(e)
+      end
+
+      # Make a PUT request
+      # @param path [String] Request path
+      # @param body [Hash] Request body
+      # @return [Hash] Response body
+      def put(path, body: {})
+        response = @connection.put(path) do |req|
+          req.body = body.to_json
+        end
+        response.body
+      rescue Faraday::Error => e
+        raise Astroapi::Error.from_faraday_error(e)
+      end
+
+      # Make a DELETE request
+      # @param path [String] Request path
+      # @return [Hash] Response body
+      def delete(path)
+        response = @connection.delete(path)
+        response.body
+      rescue Faraday::Error => e
+        raise Astroapi::Error.from_faraday_error(e)
+      end
+
+      private
+
+      def build_connection
+        Faraday.new(url: @config.base_url) do |faraday|
+          # Request middleware
+          faraday.request :json
+
+          # Custom middleware
+          faraday.use Middleware::Authentication, @config
+          faraday.use Middleware::Logger, @config
+
+          # Retry middleware (if configured)
+          if @config.retry.attempts.positive?
+            faraday.request :retry,
+                            max: @config.retry.attempts,
+                            interval: (@config.retry.delay_ms / 1000.0),
+                            retry_statuses: @config.retry.retry_status_codes,
+                            methods: %i[get post put delete],
+                            exceptions: [
+                              Faraday::TimeoutError,
+                              Faraday::ConnectionFailed,
+                              Errno::ETIMEDOUT,
+                              Errno::ECONNREFUSED
+                            ]
+          end
+
+          # Response middleware (runs in reverse order for responses)
+          faraday.use Middleware::ResponseUnwrapper
+          faraday.response :raise_error
+          faraday.response :json, content_type: /\bjson$/
+
+          # Adapter
+          faraday.adapter Faraday.default_adapter
+
+          # Timeout
+          faraday.options.timeout = @config.timeout
+          faraday.options.open_timeout = @config.timeout
+        end
+      end
+    end
+  end
+end

data/lib/astroapi/http/middleware/authentication.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Astroapi
+  module HTTP
+    module Middleware
+      # Faraday middleware to add Bearer token authentication
+      class Authentication < Faraday::Middleware
+        def initialize(app, config)
+          super(app)
+          @config = config
+        end
+
+        def call(env)
+          if @config.api_key && !env.request_headers['Authorization']
+            env.request_headers['Authorization'] = "Bearer #{@config.api_key}"
+          end
+          @app.call(env)
+        end
+      end
+    end
+  end
+end

data/lib/astroapi/http/middleware/logger.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Astroapi
+  module HTTP
+    module Middleware
+      # Faraday middleware for debug logging
+      class Logger < Faraday::Middleware
+        def initialize(app, config)
+          super(app)
+          @config = config
+        end
+
+        def call(env)
+          log_request(env) if @config.debug
+
+          @app.call(env).on_complete do |response_env|
+            log_response(response_env) if @config.debug
+          end
+        end
+
+        private
+
+        def log_request(env)
+          @config.logger.debug("[Astroapi] Request: #{env.method.upcase} #{env.url}")
+          @config.logger.debug("[Astroapi] Request Headers: #{sanitize_headers(env.request_headers)}")
+          @config.logger.debug("[Astroapi] Request Body: #{env.body}") if env.body
+        end
+
+        def log_response(env)
+          @config.logger.debug("[Astroapi] Response: #{env.status}")
+          @config.logger.debug("[Astroapi] Response Headers: #{env.response_headers}")
+          @config.logger.debug("[Astroapi] Response Body: #{env.body}")
+        end
+
+        def sanitize_headers(headers)
+          sanitized = headers.dup
+          sanitized['Authorization'] = '[REDACTED]' if sanitized['Authorization']
+          sanitized
+        end
+      end
+    end
+  end
+end

data/lib/astroapi/http/middleware/response_unwrapper.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Astroapi
+  module HTTP
+    module Middleware
+      # Faraday middleware to unwrap API response envelopes
+      # The API returns responses wrapped in { data: {...} } or { result: {...} }
+      # This middleware extracts the inner payload transparently
+      class ResponseUnwrapper < Faraday::Middleware
+        def on_complete(env)
+          env[:body] = unwrap(env[:body]) if env[:body].is_a?(Hash)
+        end
+
+        private
+
+        def unwrap(body)
+          return body unless body.is_a?(Hash)
+
+          # Try to extract 'data' first, then 'result', otherwise return body as-is
+          body.fetch('data') { body.fetch('result', body) }
+        end
+      end
+    end
+  end
+end

data/lib/astroapi/validators/base_validator.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Astroapi
+  module Validators
+    # Base validator class for input validation
+    class BaseValidator
+      def self.validate!(value, context = nil)
+        new(value, context).validate!
+      end
+
+      def initialize(value, context = nil)
+        @value = value
+        @context = context
+        @errors = []
+      end
+
+      def validate!
+        perform_validation
+        raise ValidationError, error_message unless @errors.empty?
+      end
+
+      protected
+
+      def perform_validation
+        raise NotImplementedError, 'Subclasses must implement perform_validation'
+      end
+
+      def add_error(message)
+        @errors << message
+      end
+
+      def error_message
+        @errors.join('; ')
+      end
+
+      def validate_presence(hash, key, label = nil)
+        label ||= key.to_s
+        add_error("#{label} is required") if hash.nil? || !hash.key?(key) || hash[key].nil?
+      end
+
+      def validate_range(value, range, label)
+        return if value.nil?
+
+        return if range.cover?(value)
+
+        add_error("#{label} must be between #{range.min} and #{range.max}, got #{value}")
+      end
+
+      def validate_type(value, type, label)
+        return if value.nil?
+
+        return if value.is_a?(type)
+
+        add_error("#{label} must be a #{type}, got #{value.class}")
+      end
+
+      def validate_enum(value, allowed_values, label)
+        return if value.nil?
+
+        return if allowed_values.include?(value)
+
+        add_error("#{label} must be one of #{allowed_values.join(', ')}, got #{value}")
+      end
+
+      def validate_string_non_empty(value, label)
+        return if value.nil?
+
+        add_error("#{label} must be a non-empty string") unless value.is_a?(String) && !value.strip.empty?
+      end
+    end
+  end
+end

data/lib/astroapi/validators/subject_validator.rb

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+require_relative 'base_validator'
+
+module Astroapi
+  module Validators
+    # Validator for subject/birth data
+    class SubjectValidator < BaseValidator
+      protected
+
+      def perform_validation
+        return add_error('Subject must be a Hash') unless @value.is_a?(Hash)
+
+        validate_birth_data
+        validate_location
+      end
+
+      private
+
+      def validate_birth_data
+        birth_data = @value[:birth_data] || @value['birth_data']
+        return add_error('birth_data is required') if birth_data.nil?
+        return add_error('birth_data must be a Hash') unless birth_data.is_a?(Hash)
+
+        # Validate date components
+        validate_presence(birth_data, :year, 'year')
+        validate_presence(birth_data, :month, 'month')
+        validate_presence(birth_data, :day, 'day')
+
+        year = birth_data[:year] || birth_data['year']
+        month = birth_data[:month] || birth_data['month']
+        day = birth_data[:day] || birth_data['day']
+
+        validate_range(year, 1800..2200, 'year')
+        validate_range(month, 1..12, 'month')
+        validate_range(day, 1..31, 'day')
+
+        # Validate time components
+        validate_presence(birth_data, :hour, 'hour')
+        validate_presence(birth_data, :minute, 'minute')
+
+        hour = birth_data[:hour] || birth_data['hour']
+        minute = birth_data[:minute] || birth_data['minute']
+
+        validate_range(hour, 0..23, 'hour')
+        validate_range(minute, 0..59, 'minute')
+      end
+
+      def validate_location
+        birth_data = @value[:birth_data] || @value['birth_data']
+        return if birth_data.nil?
+
+        city = birth_data[:city] || birth_data['city']
+        country_code = birth_data[:country_code] || birth_data['country_code']
+        latitude = birth_data[:latitude] || birth_data['latitude']
+        longitude = birth_data[:longitude] || birth_data['longitude']
+
+        has_city_location = city && country_code
+        has_coordinates = latitude && longitude
+
+        unless has_city_location || has_coordinates
+          add_error('Either city/country_code OR latitude/longitude is required')
+        end
+
+        # Validate coordinates if provided
+        if latitude || longitude
+          validate_range(latitude, -90..90, 'latitude') if latitude
+          validate_range(longitude, -180..180, 'longitude') if longitude
+
+          if (latitude && !longitude) || (!latitude && longitude)
+            add_error('Both latitude and longitude must be provided together')
+          end
+        end
+
+        # Validate city/country if provided
+        return unless city || country_code
+
+        validate_string_non_empty(city, 'city') if city
+        validate_string_non_empty(country_code, 'country_code') if country_code
+
+        return unless (city && !country_code) || (!city && country_code)
+
+        add_error('Both city and country_code must be provided together')
+      end
+    end
+  end
+end

data/lib/astroapi/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Astroapi
+  VERSION = '1.0.0'
+end

data/lib/astroapi.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require_relative 'astroapi/version'
+require_relative 'astroapi/error'
+require_relative 'astroapi/configuration'
+require_relative 'astroapi/client'
+
+# Main module for the Astrology API Ruby client
+module Astroapi
+  class << self
+    # Create a new client instance
+    # @param options [Hash] Configuration options
+    # @return [Client] New client instance
+    def new(options = {}, &block)
+      Client.new(options, &block)
+    end
+  end
+end

metadata

@@ -0,0 +1,218 @@
+--- !ruby/object:Gem::Specification
+name: astroapi-ruby
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Astrology API
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-02-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: faraday-retry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.50'
+- !ruby/object:Gem::Dependency
+  name: rubocop-rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.20'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.22'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.18'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: A comprehensive Ruby SDK for the Astrology API (api.astrology-api.io),
+  providing access to planetary positions, charts, horoscopes, analysis, and more.
+email:
+- support@astrology-api.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/astroapi.rb
+- lib/astroapi/categories/analysis.rb
+- lib/astroapi/categories/astrocartography.rb
+- lib/astroapi/categories/base_category.rb
+- lib/astroapi/categories/charts.rb
+- lib/astroapi/categories/chinese.rb
+- lib/astroapi/categories/data.rb
+- lib/astroapi/categories/eclipses.rb
+- lib/astroapi/categories/enhanced.rb
+- lib/astroapi/categories/fengshui.rb
+- lib/astroapi/categories/fixed_stars.rb
+- lib/astroapi/categories/glossary.rb
+- lib/astroapi/categories/horary.rb
+- lib/astroapi/categories/horoscope.rb
+- lib/astroapi/categories/human_design.rb
+- lib/astroapi/categories/insights.rb
+- lib/astroapi/categories/insights/business.rb
+- lib/astroapi/categories/insights/financial.rb
+- lib/astroapi/categories/insights/pet.rb
+- lib/astroapi/categories/insights/relationship.rb
+- lib/astroapi/categories/insights/wellness.rb
+- lib/astroapi/categories/kabbalah.rb
+- lib/astroapi/categories/lunar.rb
+- lib/astroapi/categories/numerology.rb
+- lib/astroapi/categories/palmistry.rb
+- lib/astroapi/categories/pdf.rb
+- lib/astroapi/categories/render.rb
+- lib/astroapi/categories/svg.rb
+- lib/astroapi/categories/tarot.rb
+- lib/astroapi/categories/traditional.rb
+- lib/astroapi/categories/vedic.rb
+- lib/astroapi/categories/ziwei.rb
+- lib/astroapi/client.rb
+- lib/astroapi/configuration.rb
+- lib/astroapi/error.rb
+- lib/astroapi/http/client.rb
+- lib/astroapi/http/middleware/authentication.rb
+- lib/astroapi/http/middleware/logger.rb
+- lib/astroapi/http/middleware/response_unwrapper.rb
+- lib/astroapi/validators/base_validator.rb
+- lib/astroapi/validators/subject_validator.rb
+- lib/astroapi/version.rb
+homepage: https://github.com/astro-api/astroapi-ruby
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/astro-api/astroapi-ruby/issues
+  changelog_uri: https://github.com/astro-api/astroapi-ruby/blob/main/CHANGELOG.md
+  documentation_uri: https://www.rubydoc.info/gems/astroapi-ruby
+  homepage_uri: https://github.com/astro-api/astroapi-ruby
+  source_code_uri: https://github.com/astro-api/astroapi-ruby
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Ruby client for the Astrology API
+test_files: []