astroinsightapi-sdk 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: be7de757a8f0f76a1be44455df4f1ec3ec9ec00a8d734c2dde38d9e795ed3d76
+  data.tar.gz: a1557523f2eeeeb51820af64ea67cb75b576484133795b30a3925b4e01a0d69e
+SHA512:
+  metadata.gz: 68cab9919e0a29b4c1ae09384071fa4cc3849d044552fd2194fd573aff6cfc171c7e5e2f0bbb8b49ad867ddb7fadf21eba5a63eff9faf7fdef2eb7bb875215bf
+  data.tar.gz: bb15541f85527eee6e722fcc56aa6fac065846b9fad1ee6ecf528b2db73524b02e61be8426d5bdf169ab7b64d090a313049ad7fae774d77511d3f6e0b2473a81

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Astro Insight
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,153 @@
+# astroinsightapi-sdk (Ruby Gem)
+
+[![Gem Version](https://badge.fury.io/rb/astroinsightapi-sdk.svg)](https://badge.fury.io/rb/astroinsightapi-sdk)
+[![Ruby Version](https://img.shields.io/badge/ruby-2.7%2B-red.svg)](https://www.ruby-lang.org/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE.txt)
+
+Official, idiomatic **Ruby Gem** for the **Astro Insight API**. Provides zero-dependency, pure Ruby access to Vedic Astrology, Western Astrology, Matchmaking, Panchang, Muhurta, Tarot, Numerology, Chinese Astrology, and Geolocation services.
+
+---
+
+## Features
+
+- 🪐 **Vedic Astrology**: Ashtakvarga, Vimshottari / Char / Yogini Dashas, KP System, Jaimini, Lal Kitab, Varshaphal, Ghat Chakra, Horoscope Charts & Doshas.
+- 💍 **Matchmaking**: Guna Milan, Kundali Compatibility, Manglik Matching.
+- 🗓️ **Panchang & Muhurta**: Daily Panchang, Choghadiya, Hora, Shubh Muhurta timing.
+- 🔮 **Western Astrology & Tarot**: Natal Charts, Solar Return, Transits, Synastry, Tarot spreads (One-card, Three-card, Celtic Cross, Love, Career).
+- 🔢 **Numerology**: Vedic & Western Numerology (Life Path, Destiny, Soul Urge).
+- ☯️ **Chinese Astrology & Biorhythm**: Zodiac sign compatibility & biorhythm calculations.
+- 🌍 **Geo Utilities**: Place search, timezone lookup by coordinates or ID.
+- ⚡ **Zero External Dependencies**: Pure Ruby `Net::HTTP` transport.
+
+---
+
+## Installation
+
+Add this line to your application's `Gemfile`:
+
+```ruby
+gem 'astroinsightapi-sdk'
+```
+
+And then execute:
+
+```bash
+bundle install
+```
+
+Or install it directly via `gem`:
+
+```bash
+gem install astroinsightapi-sdk
+```
+
+---
+
+## Quick Start
+
+```ruby
+require 'astroinsightapi-sdk'
+
+client = AstroInsight::Client.new(
+  client_id: 'YOUR_CLIENT_ID',
+  client_secret: 'YOUR_CLIENT_SECRET'
+)
+
+birth = AstroInsight::Models::BirthDetails.new(
+  day: 15, month: 8, year: 1995,
+  hour: 10, min: 30, sec: 0,
+  tzone: 5.5, lat: 28.6139, lon: 77.2090
+)
+
+# Fetch Birth Details
+details = client.vedic.astro_details.get_birth_details(birth)
+puts details['data']['birth_details']['day'] # Tuesday
+
+# Fetch Sun Bhinnashtakavarga
+ashtak = client.vedic.ashtakvarga.get_planet_ashtak('sun', birth)
+
+# One Card Tarot Reading
+tarot = client.tarot.get_one_card_reading
+```
+
+---
+
+## Code Examples
+
+### 🪐 Vedic Astrology & Dashas
+
+```ruby
+# Major Vimshottari Dasha
+dasha = client.vedic.vimshottari_dasha.get_major_dasha(birth)
+
+# Gemstone Suggestions
+remedies = client.vedic.suggestions.get_gemstone_suggestions(birth)
+
+# Manglik Dosha Check
+manglik = client.vedic.horoscope_dosha.get_manglik_dosha(birth)
+```
+
+### 💍 Matchmaking (Guna Milan)
+
+```ruby
+male = AstroInsight::Models::BirthDetails.new(day: 15, month: 8, year: 1995, hour: 10, min: 30)
+female = AstroInsight::Models::BirthDetails.new(day: 20, month: 11, year: 1997, hour: 14, min: 15)
+
+match_input = AstroInsight::Models::MatchInput.new(male: male, female: female)
+
+# Calculate Guna Milan
+score = client.vedic.match_making.get_guna_milan(match_input)
+```
+
+### 🗓️ Daily Panchang & Muhurta
+
+```ruby
+panchang = client.vedic.panchang.get_daily_panchang(birth)
+choghadiya = client.vedic.muhurta.get_choghadiya(birth)
+```
+
+### 🔮 Horoscope & Geo Services
+
+```ruby
+# Daily Horoscope for Leo
+leo_daily = client.horoscope.get_daily_horoscope('leo')
+
+# Search Place Coordinates
+place_info = client.geo.search_place('Delhi')
+```
+
+---
+
+## Dynamic Configuration & Headers
+
+```ruby
+# Switch language dynamically
+client.set_language('hi')
+
+# Switch Ayanamsha system
+client.set_ayanamsha('raman')
+```
+
+---
+
+## Error Handling
+
+```ruby
+begin
+  response = client.vedic.astro_details.get_birth_details(birth)
+rescue AstroInsight::AuthenticationError => e
+  puts "Auth failed: #{e.message}"
+rescue AstroInsight::ValidationError => e
+  puts "Validation failed: #{e.message}, Errors: #{e.errors}"
+rescue AstroInsight::RateLimitError => e
+  puts "Rate limit exceeded. Retry later."
+rescue AstroInsight::Error => e
+  puts "API Error [#{e.status_code}]: #{e.message}"
+end
+```
+
+---
+
+## License
+
+This Gem is open-sourced software licensed under the [MIT License](LICENSE.txt).

data/lib/astroinsight/client.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require_relative "configuration"
+require_relative "http_client"
+require_relative "services/vedic_container"
+require_relative "services/western_container"
+require_relative "services/horoscope"
+require_relative "services/tarot"
+require_relative "services/chinese_astrology"
+require_relative "services/geo"
+
+module AstroInsight
+  class Client
+    attr_reader :config, :http_client, :vedic, :western, :horoscope, :tarot, :chinese, :geo
+
+    def initialize(client_id: nil, client_secret: nil, base_url: nil, language: "en", ayanamsha: "lahiri", timeout: 30)
+      @config = Configuration.new(
+        client_id: client_id,
+        client_secret: client_secret,
+        base_url: base_url,
+        language: language,
+        ayanamsha: ayanamsha,
+        timeout: timeout
+      )
+
+      @http_client = HttpClient.new(@config)
+
+      @vedic = Services::VedicContainer.new(@http_client)
+      @western = Services::WesternContainer.new(@http_client)
+      @horoscope = Services::HoroscopeService.new(@http_client)
+      @tarot = Services::TarotService.new(@http_client)
+      @chinese = Services::ChineseAstrologyService.new(@http_client)
+      @geo = Services::GeoService.new(@http_client)
+    end
+
+    def set_language(language)
+      @config.language = language
+      self
+    end
+
+    def set_ayanamsha(ayanamsha)
+      @config.ayanamsha = ayanamsha
+      self
+    end
+  end
+end

data/lib/astroinsight/configuration.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module AstroInsight
+  class Configuration
+    attr_accessor :client_id, :client_secret, :base_url, :language, :ayanamsha, :timeout
+
+    DEFAULT_BASE_URL = "https://json.astroinsightapi.com/api/v1/"
+
+    def initialize(client_id: nil, client_secret: nil, base_url: nil, language: "en", ayanamsha: "lahiri", timeout: 30)
+      @client_id = client_id
+      @client_secret = client_secret
+      url = base_url || DEFAULT_BASE_URL
+      @base_url = url.end_with?("/") ? url : "#{url}/"
+      @language = language
+      @ayanamsha = ayanamsha
+      @timeout = timeout
+    end
+
+    def headers
+      {
+        "Accept" => "application/json",
+        "Content-Type" => "application/json",
+        "Accept-Language" => @language,
+        "X-Ayanamsha" => @ayanamsha
+      }
+    end
+  end
+end

data/lib/astroinsight/error.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module AstroInsight
+  class Error < StandardError
+    attr_reader :status_code, :response_body
+
+    def initialize(message, status_code = nil, response_body = nil)
+      @status_code = status_code
+      @response_body = response_body
+      super(message)
+    end
+  end
+
+  class AuthenticationError < Error; end
+
+  class ValidationError < Error
+    attr_reader :errors
+
+    def initialize(message, status_code = 422, response_body = nil, errors = {})
+      @errors = errors
+      super(message, status_code, response_body)
+    end
+  end
+
+  class RateLimitError < Error; end
+
+  class ServerError < Error; end
+end

data/lib/astroinsight/http_client.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "uri"
+require "json"
+
+module AstroInsight
+  class HttpClient
+    def initialize(config)
+      @config = config
+    end
+
+    def post(endpoint, payload = {})
+      url = build_url(endpoint)
+      request = Net::HTTP::Post.new(url.path, @config.headers)
+      request.basic_auth(@config.client_id, @config.client_secret)
+      request.body = payload.respond_to?(:to_h) ? payload.to_h.to_json : payload.to_json
+
+      execute(url, request)
+    end
+
+    def get(endpoint, params = {})
+      url = build_url(endpoint)
+      url.query = URI.encode_www_form(params) unless params.empty?
+
+      request = Net::HTTP::Get.new(url.request_uri, @config.headers)
+      request.basic_auth(@config.client_id, @config.client_secret)
+
+      execute(url, request)
+    end
+
+    private
+
+    def build_url(endpoint)
+      clean_endpoint = endpoint.to_s.sub(%r{^/}, "")
+      URI.join(@config.base_url, clean_endpoint)
+    end
+
+    def execute(url, request)
+      http = Net::HTTP.new(url.host, url.port)
+      http.use_ssl = (url.scheme == "https")
+      http.open_timeout = @config.timeout
+      http.read_timeout = @config.timeout
+
+      response = http.request(request)
+      data = parse_response(response.body)
+
+      unless response.is_a?(Net::HTTPSuccess)
+        handle_error(response.code.to_i, data, response.message)
+      end
+
+      data
+    rescue Timeout::Error, Errno::EINVAL, Errno::ECONNRESET, EOFError, Net::HTTPBadResponse, Net::HTTPHeaderSyntaxError, Net::ProtocolError => e
+      raise AstroInsight::Error.new("Network request failed: #{e.message}")
+    end
+
+    def parse_response(body)
+      return {} if body.nil? || body.strip.empty?
+      JSON.parse(body)
+    rescue JSON::ParserError
+      {}
+    end
+
+    def handle_error(status_code, data, message)
+      msg = data.is_a?(Hash) && data["message"] ? data["message"] : message
+
+      case status_code
+      when 401, 403
+        raise AstroInsight::AuthenticationError.new(msg, status_code, data)
+      when 422
+        errors = data.is_a?(Hash) && data["errors"] ? data["errors"] : {}
+        raise AstroInsight::ValidationError.new(msg, status_code, data, errors)
+      when 429
+        raise AstroInsight::RateLimitError.new(msg, status_code, data)
+      when 500..599
+        raise AstroInsight::ServerError.new(msg, status_code, data)
+      else
+        raise AstroInsight::Error.new(msg, status_code, data)
+      end
+    end
+  end
+end

data/lib/astroinsight/models/birth_details.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module AstroInsight
+  module Models
+    class BirthDetails
+      attr_accessor :day, :month, :year, :hour, :min, :sec, :tzone, :lat, :lon
+
+      def initialize(day:, month:, year:, hour:, min:, sec: 0, tzone: 5.5, lat: 28.6139, lon: 77.2090)
+        @day = day.to_i
+        @month = month.to_i
+        @year = year.to_i
+        @hour = hour.to_i
+        @min = min.to_i
+        @sec = sec.to_i
+        @tzone = tzone.to_f
+        @lat = lat.to_f
+        @lon = lon.to_f
+      end
+
+      def to_h
+        {
+          day: @day,
+          month: @month,
+          year: @year,
+          hour: @hour,
+          min: @min,
+          sec: @sec,
+          tzone: @tzone,
+          lat: @lat,
+          lon: @lon
+        }
+      end
+
+      def to_json(*_args)
+        to_h.to_json
+      end
+    end
+  end
+end

data/lib/astroinsight/models/geo_location.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module AstroInsight
+  module Models
+    class GeoLocation
+      attr_accessor :lat, :lon, :tzone
+
+      def initialize(lat:, lon:, tzone: 5.5)
+        @lat = lat.to_f
+        @lon = lon.to_f
+        @tzone = tzone.to_f
+      end
+
+      def to_h
+        {
+          lat: @lat,
+          lon: @lon,
+          tzone: @tzone
+        }
+      end
+
+      def to_json(*_args)
+        to_h.to_json
+      end
+    end
+  end
+end

data/lib/astroinsight/models/match_input.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require_relative "birth_details"
+
+module AstroInsight
+  module Models
+    class MatchInput
+      attr_accessor :male, :female
+
+      def initialize(male:, female:)
+        @male = male.is_a?(BirthDetails) ? male : BirthDetails.new(**male.transform_keys(&:to_sym))
+        @female = female.is_a?(BirthDetails) ? female : BirthDetails.new(**female.transform_keys(&:to_sym))
+      end
+
+      def to_h
+        m = @male.to_h
+        f = @female.to_h
+
+        {
+          m_day: m[:day],
+          m_month: m[:month],
+          m_year: m[:year],
+          m_hour: m[:hour],
+          m_min: m[:min],
+          m_sec: m[:sec],
+          m_tzone: m[:tzone],
+          m_lat: m[:lat],
+          m_lon: m[:lon],
+          f_day: f[:day],
+          f_month: f[:month],
+          f_year: f[:year],
+          f_hour: f[:hour],
+          f_min: f[:min],
+          f_sec: f[:sec],
+          f_tzone: f[:tzone],
+          f_lat: f[:lat],
+          f_lon: f[:lon]
+        }
+      end
+
+      def to_json(*_args)
+        to_h.to_json
+      end
+    end
+  end
+end

data/lib/astroinsight/services/chinese_astrology.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require "cgi"
+
+module AstroInsight
+  module Services
+    class ChineseAstrologyService
+      def initialize(client)
+        @client = client
+      end
+
+      def get_zodiac(birth_details)
+        payload = birth_details.respond_to?(:to_h) ? birth_details.to_h : birth_details
+        @client.post("/chinese/zodiac", payload)
+      end
+
+      def get_detailed_zodiac(birth_details)
+        payload = birth_details.respond_to?(:to_h) ? birth_details.to_h : birth_details
+        @client.post("/chinese/zodiac/detailed", payload)
+      end
+
+      def get_compatibility(payload)
+        @client.post("/chinese/zodiac/compatibility", payload)
+      end
+
+      def get_compatibility_by_sign(sign_key, payload = {})
+        @client.post("/chinese/zodiac/compatibility/#{CGI.escape(sign_key)}", payload)
+      end
+
+      def get_compatibility_report(your_sign_key, partner_sign_key, payload = {})
+        @client.post("/chinese/zodiac/compatibility/#{CGI.escape(your_sign_key)}/#{CGI.escape(partner_sign_key)}", payload)
+      end
+    end
+  end
+end

data/lib/astroinsight/services/geo.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module AstroInsight
+  module Services
+    class GeoService
+      def initialize(client)
+        @client = client
+      end
+
+      def search_place(place)
+        @client.post("/geo/search", { keyword: place })
+      end
+
+      def get_timezone_by_timezone_id(timezone_id)
+        @client.post("/geo/timezone", { timezone_id: timezone_id })
+      end
+
+      def get_timezone_by_lat_lon(lat, lon)
+        @client.post("/geo/timezone-with-lat-lon", { lat: lat, lon: lon })
+      end
+    end
+  end
+end

data/lib/astroinsight/services/horoscope.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "cgi"
+
+module AstroInsight
+  module Services
+    class HoroscopeService
+      def initialize(client)
+        @client = client
+      end
+
+      def get_daily_horoscope(sun_sign)
+        @client.post("/horoscope/daily/#{CGI.escape(sun_sign.downcase)}")
+      end
+
+      def get_detailed_daily_horoscope(sun_sign)
+        @client.post("/horoscope/daily/#{CGI.escape(sun_sign.downcase)}/detailed")
+      end
+
+      def get_tomorrow_daily_horoscope(sun_sign)
+        @client.post("/horoscope/daily/#{CGI.escape(sun_sign.downcase)}/tomorrow")
+      end
+
+      def get_yesterday_daily_horoscope(sun_sign)
+        @client.post("/horoscope/daily/#{CGI.escape(sun_sign.downcase)}/yesterday")
+      end
+
+      def get_monthly_horoscope(sun_sign)
+        @client.post("/horoscope/monthly/#{CGI.escape(sun_sign.downcase)}")
+      end
+
+      def get_detailed_monthly_horoscope(sun_sign)
+        @client.post("/horoscope/monthly/#{CGI.escape(sun_sign.downcase)}/detailed")
+      end
+    end
+  end
+end

data/lib/astroinsight/services/tarot.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module AstroInsight
+  module Services
+    class TarotService
+      def initialize(client)
+        @client = client
+      end
+
+      def get_one_card_reading(payload = {})
+        @client.post("/tarot/one-card", payload)
+      end
+
+      def get_three_card_reading(payload = {})
+        @client.post("/tarot/three-card", payload)
+      end
+
+      def get_celtic_cross_reading(payload = {})
+        @client.post("/tarot/celtic-cross", payload)
+      end
+
+      def get_health_reading(payload = {})
+        @client.post("/tarot/health", payload)
+      end
+
+      def get_career_reading(payload = {})
+        @client.post("/tarot/career", payload)
+      end
+
+      def get_finance_reading(payload = {})
+        @client.post("/tarot/finance", payload)
+      end
+
+      def get_true_love_reading(payload = {})
+        @client.post("/tarot/true-love", payload)
+      end
+
+      def get_victory_reading(payload = {})
+        @client.post("/tarot/victory", payload)
+      end
+
+      def get_spiritual_reading(payload = {})
+        @client.post("/tarot/spiritual", payload)
+      end
+
+      def get_yes_no_reading(payload = {})
+        @client.post("/tarot/yes-no", payload)
+      end
+    end
+  end
+end

data/lib/astroinsight/services/vedic/ashtakvarga.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "cgi"
+
+module AstroInsight
+  module Services
+    module Vedic
+      class AshtakvargaService
+        def initialize(client)
+          @client = client
+        end
+
+        def get_planet_ashtak(ashtak_planet_key, birth_details)
+          payload = birth_details.respond_to?(:to_h) ? birth_details.to_h : birth_details
+          @client.post("/ashtakvarga/planetashtak/#{CGI.escape(ashtak_planet_key.downcase)}", payload)
+        end
+
+        def get_sarvashtakvarga(birth_details)
+          payload = birth_details.respond_to?(:to_h) ? birth_details.to_h : birth_details
+          @client.post("/ashtakvarga/sarvashtak", payload)
+        end
+      end
+    end
+  end
+end