astroapi-ruby 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 375b371bd7cd2e2bbba91e3199e0688c7bb82bbefdf8c064d7f128713eca7495
+  data.tar.gz: 7c7a5d49c7754ea7574d9b7ca8dbf585b51c7fa0910f68ccd358e9d3d0d43fa8
+SHA512:
+  metadata.gz: 9d9634fee62e33f2c7713a1637981285314ee62b8aa6f70716119c015991467b185cc81bd4b60a26caab987d79de325b1e5e49bdabca00ac979f111216d0160b
+  data.tar.gz: 69b774cef367e3ca85625016a2e88ac5ce7f001b468e3167dcfb55930ccb3e2b812892e0299f7abc9aaccf002f83263691af1253f8101ddbd81cb2987028864c

data/lib/astroapi/categories/analysis.rb

@@ -0,0 +1,219 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+require_relative '../validators/subject_validator'
+
+module Astroapi
+  module Categories
+    # Analysis category client for interpretive reports and analyses
+    class Analysis < BaseCategory
+      # Get natal report
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Comprehensive natal interpretation
+      def get_natal_report(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('natal-report'), body: request)
+      end
+
+      # Get synastry report
+      # @param request [Hash] Two subjects' birth data
+      # @return [Hash] Relationship analysis
+      def get_synastry_report(request)
+        http.post(build_url('synastry-report'), body: request)
+      end
+
+      # Get composite report
+      # @param request [Hash] Two subjects' birth data
+      # @return [Hash] Composite chart interpretation
+      def get_composite_report(request)
+        http.post(build_url('composite-report'), body: request)
+      end
+
+      # Get compatibility analysis
+      # @param request [Hash] Two subjects' birth data
+      # @return [Hash] Compatibility assessment
+      def get_compatibility_analysis(request)
+        http.post(build_url('compatibility'), body: request)
+      end
+
+      # Get compatibility score
+      # @param request [Hash] Two subjects' birth data
+      # @return [Hash] Numeric compatibility score
+      def get_compatibility_score(request)
+        http.post(build_url('compatibility-score'), body: request)
+      end
+
+      # Get relationship analysis
+      # @param request [Hash] Two subjects' birth data
+      # @return [Hash] Relationship dynamics
+      def get_relationship_analysis(request)
+        http.post(build_url('relationship'), body: request)
+      end
+
+      # Get relationship score
+      # @param request [Hash] Two subjects' birth data
+      # @return [Hash] Numeric relationship score
+      def get_relationship_score(request)
+        http.post(build_url('relationship-score'), body: request)
+      end
+
+      # Get transit report
+      # @param request [Hash] Subject and transit date
+      # @return [Hash] Transit interpretations
+      def get_transit_report(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('transit-report'), body: request)
+      end
+
+      # Get natal transit report
+      # @param request [Hash] Subject and date range
+      # @return [Hash] Natal transit interpretations
+      def get_natal_transit_report(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('natal-transit-report'), body: request)
+      end
+
+      # Get progression report
+      # @param request [Hash] Subject and progression date
+      # @return [Hash] Progression interpretations
+      def get_progression_report(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('progression-report'), body: request)
+      end
+
+      # Get direction report
+      # @param request [Hash] Subject and direction date
+      # @return [Hash] Direction interpretations
+      def get_direction_report(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('direction-report'), body: request)
+      end
+
+      # Get lunar return report
+      # @param request [Hash] Subject and date
+      # @return [Hash] Monthly themes
+      def get_lunar_return_report(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('lunar-return-report'), body: request)
+      end
+
+      # Get solar return report
+      # @param request [Hash] Subject and year
+      # @return [Hash] Yearly themes
+      def get_solar_return_report(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('solar-return-report'), body: request)
+      end
+
+      # Get lunar return transit report
+      # @param request [Hash] Subject and date range
+      # @return [Hash] LR transit events
+      def get_lunar_return_transit_report(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('lunar-return-transit-report'), body: request)
+      end
+
+      # Get solar return transit report
+      # @param request [Hash] Subject and year
+      # @return [Hash] SR transit events
+      def get_solar_return_transit_report(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('solar-return-transit-report'), body: request)
+      end
+
+      # Get career analysis
+      # @param request [Hash] Subject birth data
+      # @return [Hash] 10th house/career focus
+      def get_career_analysis(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('career'), body: request)
+      end
+
+      # Get health analysis
+      # @param request [Hash] Subject birth data
+      # @return [Hash] 6th house/wellness focus
+      def get_health_analysis(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('health'), body: request)
+      end
+
+      # Get karmic analysis
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Past life/soul lessons
+      def get_karmic_analysis(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('karmic'), body: request)
+      end
+
+      # Get psychological analysis
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Psychological patterns
+      def get_psychological_analysis(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('psychological'), body: request)
+      end
+
+      # Get spiritual analysis
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Spiritual path
+      def get_spiritual_analysis(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('spiritual'), body: request)
+      end
+
+      # Get predictive analysis
+      # @param request [Hash] Subject and time period
+      # @return [Hash] Future trends
+      def get_predictive_analysis(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('predictive'), body: request)
+      end
+
+      # Get vocational analysis
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Career aptitudes
+      def get_vocational_analysis(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('vocational'), body: request)
+      end
+
+      # Get lunar analysis
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Moon-focused analysis
+      def get_lunar_analysis(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('lunar-analysis'), body: request)
+      end
+
+      # Get relocation analysis
+      # @param request [Hash] Subject and new location
+      # @return [Hash] Geographic relocation analysis
+      def get_relocation_analysis(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('relocation'), body: request)
+      end
+
+      # Get Venus return report
+      # @param request [Hash] Subject and return date
+      # @return [Hash] Venus return interpretation
+      def get_venus_return_report(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('venus-return-report'), body: request)
+      end
+
+      # Get Venus return transit report
+      # @param request [Hash] Subject and date range
+      # @return [Hash] Venus return transit events
+      def get_venus_return_transit_report(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('venus-return-transit-report'), body: request)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/analysis'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/astrocartography.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+require_relative '../validators/subject_validator'
+
+module Astroapi
+  module Categories
+    # Astrocartography category client for locational astrology
+    class Astrocartography < BaseCategory
+      # Get astrocartography lines
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Planetary AC/DC/MC/IC lines
+      def get_lines(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('lines'), body: request)
+      end
+
+      # Generate astrocartography map
+      # @param request [Hash] Subject birth data and map options
+      # @return [Hash] World map with lines
+      def generate_map(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('map'), body: request)
+      end
+
+      # Generate paran map
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Line crossing points
+      def generate_paran_map(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('paran-map'), body: request)
+      end
+
+      # Analyze specific location
+      # @param request [Hash] Subject and location
+      # @return [Hash] Location influences
+      def analyze_location(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('location-analysis'), body: request)
+      end
+
+      # Compare multiple locations
+      # @param request [Hash] Subject and locations
+      # @return [Hash] Multi-location comparison
+      def compare_locations(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('compare-locations'), body: request)
+      end
+
+      # Find power zones
+      # @param request [Hash] Subject and criteria
+      # @return [Hash] Optimal geographic areas
+      def find_power_zones(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('power-zones'), body: request)
+      end
+
+      # Search locations by criteria
+      # @param request [Hash] Search criteria
+      # @return [Hash] Matching locations
+      def search_locations(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('search-locations'), body: request)
+      end
+
+      # Generate relocation chart
+      # @param request [Hash] Subject and new location
+      # @return [Hash] Chart for new location
+      def generate_relocation_chart(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('relocation-chart'), body: request)
+      end
+
+      # Get line meanings
+      # @param params [Hash] Query parameters
+      # @return [Hash] Line interpretations
+      def get_line_meanings(params = {})
+        http.get(build_url('line-meanings'), params: params)
+      end
+
+      # Get supported features
+      # @param params [Hash] Query parameters
+      # @return [Hash] Available features
+      def get_supported_features(params = {})
+        http.get(build_url('supported-features'), params: params)
+      end
+
+      # Calculate astrodynes
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Astrodyne calculations
+      def calculate_astrodynes(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('astrodynes'), body: request)
+      end
+
+      # Compare astrodynes for multiple locations
+      # @param request [Hash] Subject and locations
+      # @return [Hash] Astrodyne comparison
+      def compare_astrodynes(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('astrodynes', 'compare'), body: request)
+      end
+
+      # Render astrocartography map image
+      # @param request [Hash] Subject and render options
+      # @return [Hash] Rendered map data
+      def render_map(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('render'), body: request)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/astrocartography'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/base_category.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Astroapi
+  module Categories
+    # Base class for all category clients
+    class BaseCategory
+      attr_reader :http
+
+      def initialize(http_client)
+        @http = http_client
+      end
+
+      protected
+
+      # Build URL path from segments
+      # @param segments [Array<String>] Path segments
+      # @return [String] Full path
+      def build_url(*segments)
+        path_segments = [api_prefix, *segments.compact].map { |s| s.to_s.gsub(%r{^/+|/+$}, '') }
+        "/#{path_segments.join('/')}"
+      end
+
+      # API prefix for this category (must be overridden)
+      # @return [String]
+      def api_prefix
+        raise NotImplementedError, 'Subclasses must define api_prefix'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/charts.rb

@@ -0,0 +1,119 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+require_relative '../validators/subject_validator'
+
+module Astroapi
+  module Categories
+    # Charts category client for astrological chart generation
+    class Charts < BaseCategory
+      # Get natal chart
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Natal chart data
+      def get_natal_chart(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('natal'), body: request)
+      end
+
+      # Get composite chart
+      # @param request [Hash] Two subjects' birth data
+      # @return [Hash] Composite chart data
+      def get_composite_chart(request)
+        http.post(build_url('composite'), body: request)
+      end
+
+      # Get synastry chart
+      # @param request [Hash] Two subjects' birth data
+      # @return [Hash] Synastry chart data
+      def get_synastry_chart(request)
+        http.post(build_url('synastry'), body: request)
+      end
+
+      # Get transit chart
+      # @param request [Hash] Subject and transit date
+      # @return [Hash] Transit chart data
+      def get_transit_chart(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('transit'), body: request)
+      end
+
+      # Get solar return chart
+      # @param request [Hash] Subject and return year
+      # @return [Hash] Solar return chart data
+      def get_solar_return_chart(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('solar-return'), body: request)
+      end
+
+      # Get lunar return chart
+      # @param request [Hash] Subject and return date
+      # @return [Hash] Lunar return chart data
+      def get_lunar_return_chart(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('lunar-return'), body: request)
+      end
+
+      # Get solar return transits
+      # @param request [Hash] Subject and year
+      # @return [Hash] Solar return transit events
+      def get_solar_return_transits(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('solar-return-transits'), body: request)
+      end
+
+      # Get lunar return transits
+      # @param request [Hash] Subject and date range
+      # @return [Hash] Lunar return transit events
+      def get_lunar_return_transits(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('lunar-return-transits'), body: request)
+      end
+
+      # Get progressions
+      # @param request [Hash] Subject and progression date
+      # @return [Hash] Secondary/tertiary progressions
+      def get_progressions(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('progressions'), body: request)
+      end
+
+      # Get directions
+      # @param request [Hash] Subject and direction date
+      # @return [Hash] Solar arc directions
+      def get_directions(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('directions'), body: request)
+      end
+
+      # Get natal transits
+      # @param request [Hash] Subject and date range
+      # @return [Hash] Upcoming transit events
+      def get_natal_transits(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('natal-transits'), body: request)
+      end
+
+      # Get Venus return chart
+      # @param request [Hash] Subject and return date
+      # @return [Hash] Venus return chart data
+      def get_venus_return_chart(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('venus-return'), body: request)
+      end
+
+      # Get Venus return transits
+      # @param request [Hash] Subject and date range
+      # @return [Hash] Venus return transit events
+      def get_venus_return_transits(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('venus-return-transits'), body: request)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/charts'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/chinese.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+
+module Astroapi
+  module Categories
+    # Chinese astrology and BaZi category client
+    class Chinese < BaseCategory
+      # Calculate BaZi (Four Pillars)
+      # @param request [Hash] Birth data
+      # @return [Hash] Four Pillars chart
+      def calculate_bazi(request)
+        http.post(build_url('bazi'), body: request)
+      end
+
+      # Calculate compatibility
+      # @param request [Hash] Two subjects' birth data
+      # @return [Hash] Chinese compatibility analysis
+      def calculate_compatibility(request)
+        http.post(build_url('compatibility'), body: request)
+      end
+
+      # Calculate luck pillars
+      # @param request [Hash] Birth data
+      # @return [Hash] Da Yun periods
+      def calculate_luck_pillars(request)
+        http.post(build_url('luck-pillars'), body: request)
+      end
+
+      # Calculate Ming Gua
+      # @param request [Hash] Birth data
+      # @return [Hash] Feng Shui number
+      def calculate_ming_gua(request)
+        http.post(build_url('ming-gua'), body: request)
+      end
+
+      # Get yearly forecast
+      # @param request [Hash] Birth data and year
+      # @return [Hash] Annual forecast
+      def get_yearly_forecast(request)
+        http.post(build_url('yearly-forecast'), body: request)
+      end
+
+      # Analyze year elements
+      # @param year [Integer] Year to analyze
+      # @return [Hash] Five elements for year
+      def analyze_year_elements(year)
+        http.get(build_url('elements', 'balance', year.to_s))
+      end
+
+      # Get solar terms
+      # @param year [Integer] Year
+      # @return [Hash] 24 Solar Terms
+      def get_solar_terms(year)
+        http.get(build_url('calendar', 'solar-terms', year.to_s))
+      end
+
+      # Get zodiac animal info
+      # @param animal [String] Animal name
+      # @return [Hash] Animal characteristics
+      def get_zodiac_animal(animal)
+        http.get(build_url('zodiac', animal))
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/chinese'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/data.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+require_relative '../validators/subject_validator'
+
+module Astroapi
+  module Categories
+    # Data category client for planetary positions, aspects, house cusps, etc.
+    class Data < BaseCategory
+      # Get planetary positions
+      # @example
+      #   positions = client.data.get_positions(
+      #     subject: {
+      #       birth_data: {
+      #         year: 1990, month: 5, day: 11,
+      #         hour: 14, minute: 30,
+      #         city: 'London', country_code: 'GB'
+      #       }
+      #     }
+      #   )
+      #
+      # @param request [Hash] Subject birth data
+      # @option request [Hash] :subject Subject with birth_data
+      # @return [Hash] Planetary positions with signs, degrees, retrograde status
+      # @raise [Astroapi::ValidationError] if request data is invalid
+      def get_positions(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('positions'), body: request)
+      end
+
+      # Get enhanced planetary positions with additional data
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Enhanced planetary positions
+      def get_enhanced_positions(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('positions', 'enhanced'), body: request)
+      end
+
+      # Get global planetary positions (without subject)
+      # @param request [Hash] Request options
+      # @option request [String] :date ISO date string (optional)
+      # @return [Hash] Global planetary positions
+      def get_global_positions(request = {})
+        http.post(build_url('global-positions'), body: request)
+      end
+
+      # Get planetary aspects
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Planetary aspects
+      def get_aspects(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('aspects'), body: request)
+      end
+
+      # Get enhanced planetary aspects
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Enhanced planetary aspects
+      def get_enhanced_aspects(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('aspects', 'enhanced'), body: request)
+      end
+
+      # Get house cusps
+      # @param request [Hash] Subject birth data
+      # @return [Hash] House cusps data
+      def get_house_cusps(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('house-cusps'), body: request)
+      end
+
+      # Get lunar metrics
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Lunar phase, illumination, etc.
+      def get_lunar_metrics(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('lunar-metrics'), body: request)
+      end
+
+      # Get enhanced lunar metrics
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Enhanced lunar metrics
+      def get_enhanced_lunar_metrics(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('lunar-metrics', 'enhanced'), body: request)
+      end
+
+      # Get current moment (planetary positions at current time)
+      # @return [Hash] Current planetary positions
+      def get_current_moment
+        http.get(build_url('now'))
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/data'
+      end
+    end
+  end
+end