astroapi-ruby 1.0.0

data/lib/astroapi/categories/eclipses.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+require_relative '../validators/subject_validator'
+
+module Astroapi
+  module Categories
+    # Eclipses category client for eclipse data and analysis
+    class Eclipses < BaseCategory
+      # Get upcoming eclipses
+      # @param params [Hash] Query parameters for filtering
+      # @return [Hash] Upcoming eclipses list
+      def get_upcoming(params = {})
+        http.get(build_url('upcoming'), params: params)
+      end
+
+      # Check natal impact
+      # @param request [Hash] Subject birth data and eclipse
+      # @return [Hash] Eclipse impact on chart
+      def check_natal_impact(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('natal-check'), body: request)
+      end
+
+      # Get eclipse interpretation
+      # @param request [Hash] Subject and eclipse data
+      # @return [Hash] Eclipse interpretation
+      def get_interpretation(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('interpretation'), body: request)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/eclipses'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/enhanced.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+require_relative '../validators/subject_validator'
+
+module Astroapi
+  module Categories
+    # Enhanced category client for enhanced analysis with chart data
+    class Enhanced < BaseCategory
+      # Get global analysis
+      # @param request [Hash] Date, time, location
+      # @return [Hash] Analysis without birth chart
+      def get_global_analysis(request)
+        http.post(build_url('global-analysis'), body: request)
+      end
+
+      # Get personal analysis
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Birth chart analysis
+      def get_personal_analysis(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('personal-analysis'), body: request)
+      end
+
+      # Get global analysis with chart
+      # @param request [Hash] Date, time, location
+      # @return [Hash] Analysis with chart rendering data
+      def get_global_analysis_chart(request)
+        http.post(build_custom_url('/api/v3/enhanced_charts', 'global-analysis'), body: request)
+      end
+
+      # Get personal analysis with chart
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Analysis with chart rendering data
+      def get_personal_analysis_chart(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_custom_url('/api/v3/enhanced_charts', 'personal-analysis'), body: request)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/enhanced'
+      end
+
+      # Build URL with custom prefix (for enhanced_charts endpoints)
+      def build_custom_url(prefix, *segments)
+        path_segments = [prefix, *segments.compact].map { |s| s.to_s.gsub(%r{^/+|/+$}, '') }
+        "/#{path_segments.join('/')}"
+      end
+    end
+  end
+end

data/lib/astroapi/categories/fengshui.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+
+module Astroapi
+  module Categories
+    # Feng Shui category client
+    class Fengshui < BaseCategory
+      # Calculate Flying Stars chart
+      # @param request [Hash] Building data
+      # @return [Hash] Flying Stars chart
+      def calculate_flying_stars_chart(request)
+        http.post(build_url('flying-stars', 'chart'), body: request)
+      end
+
+      # Get annual Flying Stars
+      # @param year [Integer] Year
+      # @return [Hash] Annual Flying Stars positions
+      def get_annual_flying_stars(year)
+        http.get(build_url('flying-stars', 'annual', year))
+      end
+
+      # Get annual afflictions
+      # @param year [Integer] Year
+      # @return [Hash] Annual afflictions
+      def get_afflictions(year)
+        http.get(build_url('afflictions', year))
+      end
+
+      # Get Flying Stars glossary
+      # @param params [Hash] Query parameters
+      # @return [Hash] Stars reference
+      def get_stars_glossary(params = {})
+        http.get(build_url('glossary', 'stars'), params: params)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/fengshui'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/fixed_stars.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+require_relative '../validators/subject_validator'
+
+module Astroapi
+  module Categories
+    # Fixed stars astrology category client
+    class FixedStars < BaseCategory
+      # Get fixed star positions
+      # @param request [Hash] Date and time
+      # @return [Hash] Star positions
+      def get_positions(request)
+        http.post(build_url('positions'), body: request)
+      end
+
+      # Get conjunctions
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Stars conjunct natal planets
+      def get_conjunctions(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('conjunctions'), body: request)
+      end
+
+      # Generate report
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Fixed stars interpretation
+      def generate_report(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('report'), body: request)
+      end
+
+      # Get presets
+      # @param params [Hash] Query parameters
+      # @return [Hash] Royal Stars, Behenian, etc.
+      def get_presets(params = {})
+        http.get(build_url('presets'), params: params)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/fixed-stars'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/glossary.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+
+module Astroapi
+  module Categories
+    # Glossary category client for reference data and lookups
+    class Glossary < BaseCategory
+      # Get all active points
+      # @param params [Hash] Query parameters
+      # @return [Hash] All astrological points
+      def get_active_points(params = {})
+        http.get(build_url('active-points'), params: params)
+      end
+
+      # Get primary active points
+      # @param params [Hash] Query parameters
+      # @return [Hash] Main planets
+      def get_primary_active_points(params = {})
+        http.get(build_url('active-points', 'primary'), params: params)
+      end
+
+      # Get cities
+      # @param params [Hash] Query parameters for search
+      # @return [Hash] City search results (paginated)
+      def get_cities(params = {})
+        http.get(build_url('cities'), params: params)
+      end
+
+      # Get countries
+      # @param params [Hash] Query parameters
+      # @return [Hash] ISO country codes
+      def get_countries(params = {})
+        http.get(build_url('countries'), params: params)
+      end
+
+      # Get elements
+      # @param params [Hash] Query parameters
+      # @return [Hash] Fire, Earth, Air, Water
+      def get_elements(params = {})
+        http.get(build_url('elements'), params: params)
+      end
+
+      # Get fixed stars
+      # @param params [Hash] Query parameters
+      # @return [Hash] Fixed star catalog
+      def get_fixed_stars(params = {})
+        http.get(build_url('fixed-stars'), params: params)
+      end
+
+      # Get house systems
+      # @param params [Hash] Query parameters
+      # @return [Hash] Placidus, Whole Sign, etc.
+      def get_house_systems(params = {})
+        http.get(build_url('house-systems'), params: params)
+      end
+
+      # Get houses
+      # @param params [Hash] Query parameters
+      # @return [Hash] House meanings
+      def get_houses(params = {})
+        http.get(build_url('houses'), params: params)
+      end
+
+      # Get keywords
+      # @param params [Hash] Query parameters
+      # @return [Hash] Astrological keywords
+      def get_keywords(params = {})
+        http.get(build_url('keywords'), params: params)
+      end
+
+      # Get supported languages
+      # @param params [Hash] Query parameters
+      # @return [Hash] Supported languages
+      def get_languages(params = {})
+        http.get(build_url('languages'), params: params)
+      end
+
+      # Get life areas
+      # @param params [Hash] Query parameters
+      # @return [Hash] Life area descriptions
+      def get_life_areas(params = {})
+        http.get(build_url('life-areas'), params: params)
+      end
+
+      # Get themes
+      # @param params [Hash] Query parameters
+      # @return [Hash] Chart styling themes
+      def get_themes(params = {})
+        http.get(build_url('themes'), params: params)
+      end
+
+      # Get zodiac types
+      # @param params [Hash] Query parameters
+      # @return [Hash] Tropical, Sidereal
+      def get_zodiac_types(params = {})
+        http.get(build_url('zodiac-types'), params: params)
+      end
+
+      # Get horary categories
+      # @param params [Hash] Query parameters
+      # @return [Hash] Horary question categories
+      def get_horary_categories(params = {})
+        http.get(build_url('horary-categories'), params: params)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/glossary'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/horary.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+
+module Astroapi
+  module Categories
+    # Horary astrology category client
+    class Horary < BaseCategory
+      # Generate horary chart
+      # @param request [Hash] Question time and location
+      # @return [Hash] Horary chart data
+      def generate_chart(request)
+        http.post(build_url('chart'), body: request)
+      end
+
+      # Analyze horary question
+      # @param request [Hash] Chart data and question
+      # @return [Hash] Horary analysis
+      def analyze(request)
+        http.post(build_url('analyze'), body: request)
+      end
+
+      # Get horary aspects
+      # @param request [Hash] Chart data
+      # @return [Hash] Horary-specific aspects
+      def get_aspects(request)
+        http.post(build_url('aspects'), body: request)
+      end
+
+      # Analyze fertility question
+      # @param request [Hash] Chart data
+      # @return [Hash] Fertility analysis
+      def analyze_fertility(request)
+        http.post(build_url('fertility-analysis'), body: request)
+      end
+
+      # Get categories glossary
+      # @param params [Hash] Query parameters
+      # @return [Hash] Horary categories reference
+      def get_categories_glossary(params = {})
+        http.get(build_url('glossary', 'categories'), params: params)
+      end
+
+      # Get considerations glossary
+      # @param params [Hash] Query parameters
+      # @return [Hash] Considerations before judgment
+      def get_considerations_glossary(params = {})
+        http.get(build_url('glossary', 'considerations'), params: params)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/horary'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/horoscope.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+require_relative '../validators/subject_validator'
+
+module Astroapi
+  module Categories
+    # Horoscope category client for daily/weekly/monthly horoscopes
+    class Horoscope < BaseCategory
+      # Get personalized daily horoscope
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Personalized daily horoscope
+      def get_personal_daily_horoscope(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('personal', 'daily'), body: request)
+      end
+
+      # Get personalized daily horoscope text
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Formatted horoscope text
+      def get_personal_daily_horoscope_text(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('personal', 'daily', 'text'), body: request)
+      end
+
+      # Get sign daily horoscope
+      # @param request [Hash] Sun sign and date
+      # @return [Hash] Daily horoscope by sun sign
+      def get_sign_daily_horoscope(request)
+        http.post(build_url('sign', 'daily'), body: request)
+      end
+
+      # Get sign daily horoscope text
+      # @param request [Hash] Sun sign and date
+      # @return [Hash] Formatted daily text
+      def get_sign_daily_horoscope_text(request)
+        http.post(build_url('sign', 'daily', 'text'), body: request)
+      end
+
+      # Get sign weekly horoscope
+      # @param request [Hash] Sun sign and week
+      # @return [Hash] Weekly horoscope by sun sign
+      def get_sign_weekly_horoscope(request)
+        http.post(build_url('sign', 'weekly'), body: request)
+      end
+
+      # Get sign weekly horoscope text
+      # @param request [Hash] Sun sign and week
+      # @return [Hash] Formatted weekly text
+      def get_sign_weekly_horoscope_text(request)
+        http.post(build_url('sign', 'weekly', 'text'), body: request)
+      end
+
+      # Get sign monthly horoscope
+      # @param request [Hash] Sun sign and month
+      # @return [Hash] Monthly horoscope by sun sign
+      def get_sign_monthly_horoscope(request)
+        http.post(build_url('sign', 'monthly'), body: request)
+      end
+
+      # Get sign monthly horoscope text
+      # @param request [Hash] Sun sign and month
+      # @return [Hash] Formatted monthly text
+      def get_sign_monthly_horoscope_text(request)
+        http.post(build_url('sign', 'monthly', 'text'), body: request)
+      end
+
+      # Get sign yearly horoscope
+      # @param request [Hash] Sun sign and year
+      # @return [Hash] Yearly overview by sun sign
+      def get_sign_yearly_horoscope(request)
+        http.post(build_url('sign', 'yearly'), body: request)
+      end
+
+      # Get sign yearly horoscope text
+      # @param request [Hash] Sun sign and year
+      # @return [Hash] Formatted yearly text
+      def get_sign_yearly_horoscope_text(request)
+        http.post(build_url('sign', 'yearly', 'text'), body: request)
+      end
+
+      # Get personalized weekly horoscope
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Personalized weekly horoscope
+      def get_personal_weekly_horoscope(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('personal', 'weekly'), body: request)
+      end
+
+      # Get personalized weekly horoscope text
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Formatted weekly horoscope text
+      def get_personal_weekly_horoscope_text(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('personal', 'weekly', 'text'), body: request)
+      end
+
+      # Get personalized monthly horoscope
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Personalized monthly horoscope
+      def get_personal_monthly_horoscope(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('personal', 'monthly'), body: request)
+      end
+
+      # Get personalized monthly horoscope text
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Formatted monthly horoscope text
+      def get_personal_monthly_horoscope_text(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('personal', 'monthly', 'text'), body: request)
+      end
+
+      # Get personalized yearly horoscope
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Personalized yearly horoscope
+      def get_personal_yearly_horoscope(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('personal', 'yearly'), body: request)
+      end
+
+      # Get personalized yearly horoscope text
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Formatted yearly horoscope text
+      def get_personal_yearly_horoscope_text(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('personal', 'yearly', 'text'), body: request)
+      end
+
+      # Get Chinese horoscope
+      # @param request [Hash] Birth data for BaZi
+      # @return [Hash] Chinese horoscope
+      def get_chinese_horoscope(request)
+        http.post(build_url('chinese', 'bazi'), body: request)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/horoscope'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/human_design.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+require_relative '../validators/subject_validator'
+
+module Astroapi
+  module Categories
+    # Human Design category client
+    class HumanDesign < BaseCategory
+      # Calculate bodygraph
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Full bodygraph data
+      def calculate_bodygraph(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('bodygraph'), body: request)
+      end
+
+      # Get type only
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Human Design type
+      def get_type(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('type'), body: request)
+      end
+
+      # Calculate design date
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Design (88 degrees) date
+      def calculate_design_date(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('design-date'), body: request)
+      end
+
+      # Calculate compatibility
+      # @param request [Hash] Two subjects' birth data
+      # @return [Hash] Human Design compatibility
+      def calculate_compatibility(request)
+        http.post(build_url('compatibility'), body: request)
+      end
+
+      # Calculate transit overlay
+      # @param request [Hash] Subject and transit date
+      # @return [Hash] Transit overlay on bodygraph
+      def calculate_transits(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('transits'), body: request)
+      end
+
+      # Get channels glossary
+      # @param params [Hash] Query parameters
+      # @return [Hash] Channels reference
+      def get_channels_glossary(params = {})
+        http.get(build_url('glossary', 'channels'), params: params)
+      end
+
+      # Get gates glossary
+      # @param params [Hash] Query parameters
+      # @return [Hash] Gates reference
+      def get_gates_glossary(params = {})
+        http.get(build_url('glossary', 'gates'), params: params)
+      end
+
+      # Get types glossary
+      # @param params [Hash] Query parameters
+      # @return [Hash] Types reference
+      def get_types_glossary(params = {})
+        http.get(build_url('glossary', 'types'), params: params)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/human-design'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/insights/business.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require_relative '../base_category'
+require_relative '../../validators/subject_validator'
+
+module Astroapi
+  module Categories
+    module Insights
+      # Business insights sub-client
+      class Business < BaseCategory
+        # Get team dynamics
+        # @param request [Hash] Multiple team members' birth data
+        # @return [Hash] Team dynamics analysis
+        def get_team_dynamics(request)
+          http.post(build_url('team-dynamics'), body: request)
+        end
+
+        # Get hiring compatibility
+        # @param request [Hash] Candidate and team/role data
+        # @return [Hash] Hiring compatibility analysis
+        def get_hiring_compatibility(request)
+          http.post(build_url('hiring-compatibility'), body: request)
+        end
+
+        # Get leadership style
+        # @param request [Hash] Subject birth data
+        # @return [Hash] Leadership style analysis
+        def get_leadership_style(request)
+          Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+          http.post(build_url('leadership-style'), body: request)
+        end
+
+        # Get business timing
+        # @param request [Hash] Business launch data and events
+        # @return [Hash] Business timing analysis
+        def get_business_timing(request)
+          http.post(build_url('business-timing'), body: request)
+        end
+
+        # Get department compatibility
+        # @param request [Hash] Department members' birth data
+        # @return [Hash] Department compatibility
+        def get_department_compatibility(request)
+          http.post(build_url('department-compatibility'), body: request)
+        end
+
+        # Get succession planning
+        # @param request [Hash] Current and potential leaders
+        # @return [Hash] Succession planning analysis
+        def get_succession_planning(request)
+          http.post(build_url('succession-planning'), body: request)
+        end
+
+        protected
+
+        def api_prefix
+          '/api/v3/insights/business'
+        end
+      end
+    end
+  end
+end