release: v0.1.5

Author: github-actions[bot]

AGENTS.md

@@ -36,8 +36,8 @@ $result = $roxy->location->searchCities(q: 'Mumbai');
 <!-- BEGIN:DOMAINS -->
 | Property | Endpoints | What it covers |
 |---|---|---|
-| `$roxy->astrology` | 22 | Production-ready Western astrology API + remote MCP for AI agents and developers |
-| `$roxy->vedicAstrology` | 42 | Production-grade Vedic (Jyotish) and KP astrology API + remote MCP for AI agents and developers |
+| `$roxy->astrology` | 23 | Production-ready Western astrology API + remote MCP for AI agents and developers |
+| `$roxy->vedicAstrology` | 43 | Production-grade Vedic (Jyotish) and KP astrology API + remote MCP for AI agents and developers |
 | `$roxy->numerology` | 16 | Production-ready Pythagorean numerology API + hosted MCP for AI agents and developers |
 | `$roxy->tarot` | 10 | Production-ready tarot card reading API + hosted MCP for AI agents and developers |
 | `$roxy->biorhythm` | 6 | The most complete biorhythm API + remote MCP for AI agents and developers |

README.md

@@ -55,8 +55,8 @@ Get an API key at [roxyapi.com/pricing](https://roxyapi.com/pricing). All endpoi
 <!-- BEGIN:DOMAINS -->
 | Property | Endpoints | What it covers |
 |---|---|---|
-| `$roxy->astrology` | 22 | Production-ready Western astrology API + remote MCP for AI agents and developers |
-| `$roxy->vedicAstrology` | 42 | Production-grade Vedic (Jyotish) and KP astrology API + remote MCP for AI agents and developers |
+| `$roxy->astrology` | 23 | Production-ready Western astrology API + remote MCP for AI agents and developers |
+| `$roxy->vedicAstrology` | 43 | Production-grade Vedic (Jyotish) and KP astrology API + remote MCP for AI agents and developers |
 | `$roxy->numerology` | 16 | Production-ready Pythagorean numerology API + hosted MCP for AI agents and developers |
 | `$roxy->tarot` | 10 | Production-ready tarot card reading API + hosted MCP for AI agents and developers |
 | `$roxy->biorhythm` | 6 | The most complete biorhythm API + remote MCP for AI agents and developers |

composer.json

@@ -84,5 +84,5 @@
             "/tests"
         ]
     },
-    "version": "0.1.4"
+    "version": "0.1.5"
 }

package.json

@@ -1,7 +1,7 @@
 {
   "name": "roxyapi-sdk-php-tooling",
   "private": true,
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Codegen tooling for the roxyapi/sdk Composer package. Not published.",
   "type": "module",
   "scripts": {

specs/openapi.json

@@ -0,0 +1,88 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * AUTO-GENERATED by scripts/generate.mjs from the live OpenAPI spec.
+ * Do not edit this file by hand. Regenerate with: node scripts/generate.mjs
+ */
+
+namespace RoxyAPI\Sdk\Generated\Requests;
+
+use Saloon\Enums\Method;
+use Saloon\Http\Request;
+use Saloon\Contracts\Body\HasBody;
+use Saloon\Traits\Body\HasJsonBody;
+
+/**
+ * Detect aspect patterns - Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle,
+ * Stellium
+ *
+ * Identify classical Western astrology multi-planet configurations in a birth chart. Returns
+ * Grand Trines (with element), Kites (with apex), T-Squares (with apex and modality), Grand
+ * Crosses (with modality), Yods (Finger of Fate, with apex), Mystic Rectangles, and Stelliums.
+ * Each pattern carries a tightness score (0-100), dissociate flag for out-of-sign
+ * configurations, and a one-line interpretation suitable for chart reports. Disambiguation is
+ * built in: a Grand Cross suppresses its contained T-Squares, a Kite suppresses its underlying
+ * Grand Trine. Useful for personalized natal report engines, astrology chatbots, AI agents
+ * that interpret chart geometry, and editorial chart-pattern callouts.
+ *
+ * POST /astrology/aspect-patterns
+ */
+class DetectAspectPatternsRequest extends Request implements HasBody
+{
+    use HasJsonBody;
+
+    protected Method $method = Method::POST;
+
+    public function __construct(
+        public readonly string $date,
+        public readonly float $latitude,
+        public readonly float $longitude,
+        public readonly string $time,
+        public readonly mixed $timezone,
+        public readonly ?string $include = null,
+        public readonly ?string $lang = null,
+        public readonly ?string $strictOrbs = null,
+    ) {
+    }
+
+    public function resolveEndpoint(): string
+    {
+        return "/astrology/aspect-patterns";
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected function defaultBody(): array
+    {
+        $body = [];
+        $body['date'] = $this->date;
+        $body['latitude'] = $this->latitude;
+        $body['longitude'] = $this->longitude;
+        $body['time'] = $this->time;
+        $body['timezone'] = $this->timezone;
+
+        return $body;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected function defaultQuery(): array
+    {
+        $query = [];
+        if ($this->include !== null) {
+            $query['include'] = $this->include;
+        }
+        if ($this->lang !== null) {
+            $query['lang'] = $this->lang;
+        }
+        if ($this->strictOrbs !== null) {
+            $query['strictOrbs'] = $this->strictOrbs;
+        }
+
+        return $query;
+    }
+}

src/Generated/Requests/DetectAspectPatternsRequest.php

@@ -0,0 +1,81 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * AUTO-GENERATED by scripts/generate.mjs from the live OpenAPI spec.
+ * Do not edit this file by hand. Regenerate with: node scripts/generate.mjs
+ */
+
+namespace RoxyAPI\Sdk\Generated\Requests;
+
+use Saloon\Enums\Method;
+use Saloon\Http\Request;
+use Saloon\Contracts\Body\HasBody;
+use Saloon\Traits\Body\HasJsonBody;
+
+/**
+ * Detect classical Vedic yogas in a birth chart
+ *
+ * Chart-driven detection of 12 classical Vedic yogas: Gajakesari (parashara three-rule
+ * definition), Sunapha, Anapha, Dhurdhura, Kemadruma, Chandra Mangala, Budha-Aditya, and the
+ * five Pancha Mahapurusha yogas (Ruchaka, Bhadra, Hamsa, Malavya, Sasa). Each yoga is returned
+ * with a present boolean and a classical-text evidence string naming the rule that triggered
+ * or failed (kendra position, dignity, malefic drishti, lordship, retrograde state). Unlike
+ * GET /yoga and GET /yoga/{id} which are dictionary lookups, this endpoint computes the kundli
+ * from birth data and runs the detection rules. Sources: BPHS ch. 75, Mantreswara Phaladeepika
+ * ch. 6, B.V. Raman Three Hundred Important Combinations.
+ *
+ * POST /vedic-astrology/yoga/detect
+ */
+class DetectYogasRequest extends Request implements HasBody
+{
+    use HasJsonBody;
+
+    protected Method $method = Method::POST;
+
+    public function __construct(
+        public readonly string $date,
+        public readonly float $latitude,
+        public readonly float $longitude,
+        public readonly string $time,
+        public readonly mixed $timezone = null,
+        public readonly ?string $lang = null,
+    ) {
+    }
+
+    public function resolveEndpoint(): string
+    {
+        return "/vedic-astrology/yoga/detect";
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected function defaultBody(): array
+    {
+        $body = [];
+        $body['date'] = $this->date;
+        $body['latitude'] = $this->latitude;
+        $body['longitude'] = $this->longitude;
+        $body['time'] = $this->time;
+        if ($this->timezone !== null) {
+            $body['timezone'] = $this->timezone;
+        }
+
+        return $body;
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected function defaultQuery(): array
+    {
+        $query = [];
+        if ($this->lang !== null) {
+            $query['lang'] = $this->lang;
+        }
+
+        return $query;
+    }
+}

src/Generated/Requests/DetectYogasRequest.php

@@ -13,12 +13,14 @@
 use Saloon\Http\Request;
 
 /**
- * Get yoga details by ID - Detailed Yoga Information API
+ * Get yoga details by ID - Vedic Yoga Glossary Entry
  *
- * Returns complete details for a specific yoga including formation conditions,
- * results/effects, and quality (Positive/Negative/Both). Use GET /yogas first to get the list
- * of IDs. Provides in-depth information about each planetary combination. Perfect for yoga
- * detail pages, educational content, and astrological interpretation in horoscope apps.
+ * Look up the dictionary entry for a specific named yoga from the 300-entry Vedic
+ * planetary-yoga glossary. Returns formation conditions, life results, and quality
+ * classification (Positive/Negative/Both). This is a glossary lookup against the static
+ * catalog; it does NOT analyze a birth chart. For chart-driven present/absent verdicts on the
+ * 12 classical detection-grade yogas (Gajakesari, Pancha Mahapurusha, etc.) call POST
+ * /yoga/detect with birth data.
  *
  * GET /vedic-astrology/yoga/{id}
  */

src/Generated/Requests/GetYogaRequest.php

@@ -13,12 +13,14 @@
 use Saloon\Http\Request;
 
 /**
- * List all planetary yogas - 300+ Vedic Yoga Combinations
+ * List all planetary yogas - 300+ Vedic Yoga Glossary
  *
- * Returns list of all 300+ planetary yogas (astrological combinations) with basic information
- * (id and name only). Use this to discover available yogas, then call GET /yogas/:id for
- * detailed information. Perfect for building yoga browser interfaces, search functionality,
- * and progressive data loading in astrology apps.
+ * Browse the 300+ entry Vedic planetary-yoga glossary. Returns id and name for every cataloged
+ * yoga (Raja, Dhana, Pancha Mahapurusha, Nabhasa, Chandra-Mangala, and more). This is a
+ * dictionary lookup, not chart-driven detection: it does not inspect a birth chart. Use GET
+ * /yoga/{id} for the full glossary entry, or POST /yoga/detect to run the 12 classical
+ * detection rules against a specific kundli. Ideal for yoga-browser UIs, search, and
+ * progressive data loading.
  *
  * GET /vedic-astrology/yoga
  */

src/Generated/Requests/ListYogasRequest.php

@@ -276,6 +276,65 @@ public function calculateTransits(
         return $this->callRequest($request);
     }
 
+    /**
+     * Detect aspect patterns - Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle,
+     * Stellium
+     *
+     * Identify classical Western astrology multi-planet configurations in a birth chart. Returns
+     * Grand Trines (with element), Kites (with apex), T-Squares (with apex and modality), Grand
+     * Crosses (with modality), Yods (Finger of Fate, with apex), Mystic Rectangles, and Stelliums.
+     * Each pattern carries a tightness score (0-100), dissociate flag for out-of-sign
+     * configurations, and a one-line interpretation suitable for chart reports. Disambiguation is
+     * built in: a Grand Cross suppresses its contained T-Squares, a Kite suppresses its underlying
+     * Grand Trine. Useful for personalized natal report engines, astrology chatbots, AI agents
+     * that interpret chart geometry, and editorial chart-pattern callouts.
+     *
+     * POST /astrology/aspect-patterns
+     *
+     * @param string $date
+     *   Birth date in YYYY-MM-DD format. Determines planetary positions for the specific calendar
+     *   day.
+     * @param float $latitude
+     *   Birth location latitude in decimal degrees (-90 to 90). Positive = North, negative = South.
+     * @param float $longitude
+     *   Birth location longitude in decimal degrees (-180 to 180). Positive = East, negative = West.
+     * @param string $time
+     *   Birth time in 24-hour HH:MM:SS format. Determines the Ascendant (rising sign) and house
+     *   cusps. Use 12:00:00 if unknown.
+     * @param mixed $timezone
+     *   Timezone: decimal hours from UTC (e.g. -5 for EST, 5.5 for IST) OR IANA name (e.g.
+     *   "America/New_York", "Asia/Kolkata"). IANA strings are resolved to the DST-correct offset for
+     *   the given date, so you can pass `cities[0].timezone` from /location/search directly.
+     * @param string|null $include
+     *   Comma-separated list of optional bodies to include beyond the classical 10 planets. Valid
+     *   tokens (case-insensitive): chiron, northNode (also accepts north_node, north-node,
+     *   northnode). Empty by default.
+     * @param string|null $lang
+     *   Response language (ISO 639-1). Supported: en, tr, de, es, hi, pt, fr, ru. Defaults to en.
+     *   Languages without translations yet return English.
+     * @param string|null $strictOrbs
+     *   Use tighter orbs (Pontopia "optimal" recommendations). Truthy values (true, 1, yes, on;
+     *   case-insensitive) narrow trine to 5, square to 5, sextile to 4, quincunx to 2. Defaults to
+     *   false (industry-standard orbs).
+     *
+     * @return array<string, mixed>
+     */
+    public function detectAspectPatterns(
+        string $date,
+        float $latitude,
+        float $longitude,
+        string $time,
+        mixed $timezone,
+        ?string $include = null,
+        ?string $lang = null,
+        ?string $strictOrbs = null
+    ): array
+    {
+        $request = new \RoxyAPI\Sdk\Generated\Requests\DetectAspectPatternsRequest(date: $date, latitude: $latitude, longitude: $longitude, time: $time, timezone: $timezone, include: $include, lang: $lang, strictOrbs: $strictOrbs);
+
+        return $this->callRequest($request);
+    }
+
     /**
      * Composite Chart - Midpoint relationship chart with interpretations
      *