astroapi-ruby 1.0.0

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

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+require_relative '../base_category'
+require_relative '../../validators/subject_validator'
+
+module Astroapi
+  module Categories
+    module Insights
+      # Financial insights sub-client
+      class Financial < BaseCategory
+        # Get market timing
+        # @param request [Hash] Date range and market
+        # @return [Hash] Market timing analysis
+        def get_market_timing(request)
+          http.post(build_url('market-timing'), body: request)
+        end
+
+        # Analyze personal trading
+        # @param request [Hash] Subject birth data
+        # @return [Hash] Personal trading style analysis
+        def analyze_personal_trading(request)
+          Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+          http.post(build_url('personal-trading'), body: request)
+        end
+
+        # Get Gann analysis
+        # @param request [Hash] Market and date
+        # @return [Hash] W.D. Gann analysis
+        def get_gann_analysis(request)
+          http.post(build_url('gann-analysis'), body: request)
+        end
+
+        # Get Bradley Siderograph
+        # @param request [Hash] Date range
+        # @return [Hash] Bradley Siderograph data
+        def get_bradley_siderograph(request)
+          http.post(build_url('bradley-siderograph'), body: request)
+        end
+
+        # Get crypto timing
+        # @param request [Hash] Cryptocurrency and date range
+        # @return [Hash] Crypto timing analysis
+        def get_crypto_timing(request)
+          http.post(build_url('crypto-timing'), body: request)
+        end
+
+        # Get forex timing
+        # @param request [Hash] Currency pair and date range
+        # @return [Hash] Forex timing analysis
+        def get_forex_timing(request)
+          http.post(build_url('forex-timing'), body: request)
+        end
+
+        protected
+
+        def api_prefix
+          '/api/v3/insights/financial'
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require_relative '../base_category'
+
+module Astroapi
+  module Categories
+    module Insights
+      # Pet insights sub-client
+      class Pet < BaseCategory
+        # Get pet personality
+        # @param request [Hash] Pet birth data
+        # @return [Hash] Pet personality analysis
+        def get_personality(request)
+          http.post(build_url('personality'), body: request)
+        end
+
+        # Get owner-pet compatibility
+        # @param request [Hash] Owner and pet birth data
+        # @return [Hash] Compatibility analysis
+        def get_compatibility(request)
+          http.post(build_url('compatibility'), body: request)
+        end
+
+        # Get training windows
+        # @param request [Hash] Pet birth data and date range
+        # @return [Hash] Optimal training times
+        def get_training_windows(request)
+          http.post(build_url('training-windows'), body: request)
+        end
+
+        # Get health sensitivities
+        # @param request [Hash] Pet birth data
+        # @return [Hash] Health sensitivity analysis
+        def get_health_sensitivities(request)
+          http.post(build_url('health-sensitivities'), body: request)
+        end
+
+        # Get multi-pet dynamics
+        # @param request [Hash] Multiple pets' birth data
+        # @return [Hash] Multi-pet interaction analysis
+        def get_multi_pet_dynamics(request)
+          http.post(build_url('multi-pet-dynamics'), body: request)
+        end
+
+        protected
+
+        def api_prefix
+          '/api/v3/insights/pet'
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require_relative '../base_category'
+
+module Astroapi
+  module Categories
+    module Insights
+      # Relationship insights sub-client
+      class Relationship < BaseCategory
+        # Get compatibility
+        # @param request [Hash] Two subjects' birth data
+        # @return [Hash] Compatibility analysis
+        def get_compatibility(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 love languages
+        # @param request [Hash] Two subjects' birth data
+        # @return [Hash] Love language analysis
+        def get_love_languages(request)
+          http.post(build_url('love-languages'), body: request)
+        end
+
+        # Get Davison report
+        # @param request [Hash] Two subjects' birth data
+        # @return [Hash] Davison relationship chart
+        def get_davison_report(request)
+          http.post(build_url('davison'), body: request)
+        end
+
+        # Get timing
+        # @param request [Hash] Two subjects and date range
+        # @return [Hash] Relationship timing analysis
+        def get_timing(request)
+          http.post(build_url('timing'), body: request)
+        end
+
+        # Get red flags
+        # @param request [Hash] Two subjects' birth data
+        # @return [Hash] Potential relationship challenges
+        def get_red_flags(request)
+          http.post(build_url('red-flags'), body: request)
+        end
+
+        # Discover relationship insights
+        # @param params [Hash] Query parameters
+        # @return [Hash] Available relationship insights
+        def discover(params = {})
+          http.get(build_url, params: params)
+        end
+
+        protected
+
+        def api_prefix
+          '/api/v3/insights/relationship'
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+
+require_relative '../base_category'
+require_relative '../../validators/subject_validator'
+
+module Astroapi
+  module Categories
+    module Insights
+      # Wellness insights sub-client
+      class Wellness < BaseCategory
+        # Get body mapping
+        # @param request [Hash] Subject birth data
+        # @return [Hash] Body-astrology correspondences
+        def get_body_mapping(request)
+          Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+          http.post(build_url('body-mapping'), body: request)
+        end
+
+        # Get biorhythms
+        # @param request [Hash] Subject and date range
+        # @return [Hash] Physical/emotional/intellectual cycles
+        def get_biorhythms(request)
+          Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+          http.post(build_url('biorhythms'), body: request)
+        end
+
+        # Get wellness timing
+        # @param request [Hash] Subject and date range
+        # @return [Hash] Optimal wellness activity timing
+        def get_wellness_timing(request)
+          Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+          http.post(build_url('wellness-timing'), body: request)
+        end
+
+        # Get energy patterns
+        # @param request [Hash] Subject birth data
+        # @return [Hash] Energy level patterns
+        def get_energy_patterns(request)
+          Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+          http.post(build_url('energy-patterns'), body: request)
+        end
+
+        # Get wellness score
+        # @param request [Hash] Subject and current date
+        # @return [Hash] Current wellness score
+        def get_wellness_score(request)
+          Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+          http.post(build_url('wellness-score'), body: request)
+        end
+
+        # Get moon wellness
+        # @param request [Hash] Subject and lunar phase
+        # @return [Hash] Lunar wellness recommendations
+        def get_moon_wellness(request)
+          Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+          http.post(build_url('moon-wellness'), body: request)
+        end
+
+        protected
+
+        def api_prefix
+          '/api/v3/insights/wellness'
+        end
+      end
+    end
+  end
+end

data/lib/astroapi/categories/insights.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+require_relative 'insights/relationship'
+require_relative 'insights/pet'
+require_relative 'insights/wellness'
+require_relative 'insights/financial'
+require_relative 'insights/business'
+
+module Astroapi
+  module Categories
+    # Insights category client with specialized sub-clients
+    class InsightsCategory < BaseCategory
+      attr_reader :relationship, :pet, :wellness, :financial, :business
+
+      def initialize(http_client)
+        super(http_client)
+
+        # Initialize sub-clients
+        @relationship = Insights::Relationship.new(http_client)
+        @pet = Insights::Pet.new(http_client)
+        @wellness = Insights::Wellness.new(http_client)
+        @financial = Insights::Financial.new(http_client)
+        @business = Insights::Business.new(http_client)
+      end
+
+      # Discover available insights
+      # @param params [Hash] Query parameters
+      # @return [Hash] List of available insights
+      def discover(params = {})
+        http.get(build_url, params: params)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/insights'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/kabbalah.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+require_relative '../validators/subject_validator'
+
+module Astroapi
+  module Categories
+    # Kabbalah category client
+    class Kabbalah < BaseCategory
+      # Get birth angels
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Guardian angels based on birth
+      def get_birth_angels(request)
+        Validators::SubjectValidator.validate!(request)
+        http.post(build_url('birth-angels'), body: request)
+      end
+
+      # Calculate gematria
+      # @param request [Hash] Name or text for analysis
+      # @return [Hash] Gematria calculation
+      def calculate_gematria(request)
+        http.post(build_url('gematria'), body: request)
+      end
+
+      # Get tikkun
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Soul correction analysis
+      def get_tikkun(request)
+        Validators::SubjectValidator.validate!(request)
+        http.post(build_url('tikkun'), body: request)
+      end
+
+      # Get Tree of Life chart
+      # @param request [Hash] Subject birth data
+      # @return [Hash] Kabbalistic Tree of Life mapping
+      def get_tree_of_life_chart(request)
+        Validators::SubjectValidator.validate!(request)
+        http.post(build_url('tree-of-life-chart'), body: request)
+      end
+
+      # Get 72 Angels glossary
+      # @param params [Hash] Query parameters
+      # @return [Hash] Angels reference
+      def get_angels_glossary(params = {})
+        http.get(build_url('glossary', 'angels-72'), params: params)
+      end
+
+      # Get Hebrew letters glossary
+      # @param params [Hash] Query parameters
+      # @return [Hash] Hebrew letters reference
+      def get_hebrew_letters_glossary(params = {})
+        http.get(build_url('glossary', 'hebrew-letters'), params: params)
+      end
+
+      # Get Sephiroth glossary
+      # @param params [Hash] Query parameters
+      # @return [Hash] Sephiroth reference
+      def get_sephiroth_glossary(params = {})
+        http.get(build_url('glossary', 'sephiroth'), params: params)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/kabbalah'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/lunar.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+
+module Astroapi
+  module Categories
+    # Lunar category client for Moon phases and lunar data
+    class Lunar < BaseCategory
+      # Get moon phases in date range
+      # @param request [Hash] Date range
+      # @return [Hash] Moon phases
+      def get_phases(request)
+        http.post(build_url('phases'), body: request)
+      end
+
+      # Get lunar events
+      # @param request [Hash] Date range
+      # @return [Hash] Lunar ingresses and aspects
+      def get_events(request)
+        http.post(build_url('events'), body: request)
+      end
+
+      # Get lunar mansions
+      # @param request [Hash] Date and location
+      # @return [Hash] 28 lunar mansions
+      def get_mansions(request)
+        http.post(build_url('mansions'), body: request)
+      end
+
+      # Get void of course periods
+      # @param request [Hash] Date range
+      # @return [Hash] Void-of-course periods
+      def get_void_of_course(request)
+        http.post(build_url('void-of-course'), body: request)
+      end
+
+      # Get annual lunar calendar
+      # @param year [Integer] Year
+      # @return [Hash] Lunar calendar
+      def get_calendar(year)
+        http.get(build_url('calendar', year.to_s))
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/lunar'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/numerology.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+
+module Astroapi
+  module Categories
+    # Numerology category client for numerology calculations
+    class Numerology < BaseCategory
+      # Get core numbers
+      # @param request [Hash] Name and birth data
+      # @return [Hash] Life Path, Expression, Soul Urge
+      def get_core_numbers(request)
+        http.post(build_url('core-numbers'), body: request)
+      end
+
+      # Get comprehensive report
+      # @param request [Hash] Name and birth data
+      # @return [Hash] Full numerology report
+      def get_comprehensive_report(request)
+        http.post(build_url('comprehensive'), body: request)
+      end
+
+      # Analyze compatibility
+      # @param request [Hash] Two people's names and birth data
+      # @return [Hash] Numerology compatibility
+      def analyze_compatibility(request)
+        http.post(build_url('compatibility'), body: request)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/numerology'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/palmistry.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+
+module Astroapi
+  module Categories
+    # Palmistry category client
+    class Palmistry < BaseCategory
+      # Palm analysis (raw data)
+      # @param request [Hash] Palm image or data
+      # @return [Hash] Raw palm analysis data
+      def analyze(request)
+        http.post(build_url('analysis'), body: request)
+      end
+
+      # Palm reading (full interpretation)
+      # @param request [Hash] Palm image or data
+      # @return [Hash] Full palm reading
+      def get_reading(request)
+        http.post(build_url('reading'), body: request)
+      end
+
+      # Palm-astrology integration
+      # @param request [Hash] Palm data and birth data
+      # @return [Hash] Combined palm-astrology analysis
+      def get_astro_integration(request)
+        http.post(build_url('astro'), body: request)
+      end
+
+      # Palm compatibility analysis
+      # @param request [Hash] Two palms data
+      # @return [Hash] Compatibility analysis
+      def get_compatibility(request)
+        http.post(build_url('compatibility'), body: request)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/palmistry'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/pdf.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+require_relative '../validators/subject_validator'
+
+module Astroapi
+  module Categories
+    # PDF generation category client
+    class Pdf < BaseCategory
+      # Generate natal report PDF
+      # @param request [Hash] Subject birth data
+      # @return [Hash] PDF generation result
+      def generate_natal_report(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('natal-report'), body: request)
+      end
+
+      # Generate daily horoscope PDF
+      # @param request [Hash] Sign and date
+      # @return [Hash] PDF generation result
+      def generate_daily_horoscope(request)
+        http.post(build_url('horoscope', 'daily'), body: request)
+      end
+
+      # Generate weekly horoscope PDF
+      # @param request [Hash] Sign and date range
+      # @return [Hash] PDF generation result
+      def generate_weekly_horoscope(request)
+        http.post(build_url('horoscope', 'weekly'), body: request)
+      end
+
+      # Get daily horoscope data
+      # @param sign [String] Zodiac sign
+      # @param target_date [String] Target date
+      # @return [Hash] Horoscope data for PDF
+      def get_horoscope_data(sign, target_date)
+        http.get(build_url('horoscope', 'data', sign, target_date))
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/pdf'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/render.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+require_relative '../validators/subject_validator'
+
+module Astroapi
+  module Categories
+    # Chart rendering category client (PNG images)
+    class Render < BaseCategory
+      # Render natal chart
+      # @param request [Hash] Subject birth data and render options
+      # @return [Hash] Rendered chart image data
+      def render_natal(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('natal'), body: request)
+      end
+
+      # Render synastry chart
+      # @param request [Hash] Two subjects' birth data and render options
+      # @return [Hash] Rendered synastry chart
+      def render_synastry(request)
+        http.post(build_url('synastry'), body: request)
+      end
+
+      # Render composite chart
+      # @param request [Hash] Two subjects' birth data and render options
+      # @return [Hash] Rendered composite chart
+      def render_composite(request)
+        http.post(build_url('composite'), body: request)
+      end
+
+      # Render transit chart
+      # @param request [Hash] Subject and transit data with render options
+      # @return [Hash] Rendered transit chart
+      def render_transit(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('transit'), body: request)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/render'
+      end
+    end
+  end
+end

data/lib/astroapi/categories/svg.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+require_relative 'base_category'
+require_relative '../validators/subject_validator'
+
+module Astroapi
+  module Categories
+    # SVG category client for SVG chart image generation
+    # Note: Returns SVG strings (text), not JSON
+    class Svg < BaseCategory
+      # Get natal chart SVG
+      # @param request [Hash] Subject birth data and options
+      # @return [String] SVG chart as text
+      def get_natal_chart_svg(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('natal'), body: request)
+      end
+
+      # Get synastry chart SVG
+      # @param request [Hash] Two subjects' birth data and options
+      # @return [String] SVG chart as text
+      def get_synastry_chart_svg(request)
+        http.post(build_url('synastry'), body: request)
+      end
+
+      # Get composite chart SVG
+      # @param request [Hash] Two subjects' birth data and options
+      # @return [String] SVG chart as text
+      def get_composite_chart_svg(request)
+        http.post(build_url('composite'), body: request)
+      end
+
+      # Get transit chart SVG
+      # @param request [Hash] Subject, transit date and options
+      # @return [String] SVG chart as text
+      def get_transit_chart_svg(request)
+        Validators::SubjectValidator.validate!(request[:subject] || request['subject'])
+        http.post(build_url('transit'), body: request)
+      end
+
+      protected
+
+      def api_prefix
+        '/api/v3/svg'
+      end
+    end
+  end
+end