release: v0.1.49

Author: github-actions[bot]

AGENTS.md

@@ -36,7 +36,7 @@ $result = $roxy->location->searchCities(q: 'New York');
 <!-- BEGIN:DOMAINS -->
 | Property | What it covers |
 |---|---|
-| `$roxy->astrology` | Western astrology API for natal birth charts, daily, weekly, and monthly horoscopes with unique content per sign, syn... |
+| `$roxy->astrology` | Western astrology API for natal birth charts, daily, weekly, monthly, and yearly horoscopes with unique content per s... |
 | `$roxy->vedicAstrology` | Vedic astrology (Jyotish) and KP API for kundli generation with 15 divisional charts (D1-D60), Ashtakoot Gun Milan ku... |
 | `$roxy->forecast` | Forecast API that merges upcoming transit aspects, sign ingresses, retrograde stations, new and full moons, biorhythm... |
 | `$roxy->humanDesign` | Generate the full Human Design bodygraph from a birth moment: type, strategy, inner authority, profile, definition, i... |

README.md

@@ -55,7 +55,7 @@ Get an API key at [roxyapi.com/pricing](https://roxyapi.com/pricing). All endpoi
 <!-- BEGIN:DOMAINS -->
 | Property | What it covers |
 |---|---|
-| `$roxy->astrology` | Western astrology API for natal birth charts, daily, weekly, and monthly horoscopes with unique content per sign, syn... |
+| `$roxy->astrology` | Western astrology API for natal birth charts, daily, weekly, monthly, and yearly horoscopes with unique content per s... |
 | `$roxy->vedicAstrology` | Vedic astrology (Jyotish) and KP API for kundli generation with 15 divisional charts (D1-D60), Ashtakoot Gun Milan ku... |
 | `$roxy->forecast` | Forecast API that merges upcoming transit aspects, sign ingresses, retrograde stations, new and full moons, biorhythm... |
 | `$roxy->humanDesign` | Generate the full Human Design bodygraph from a birth moment: type, strategy, inner authority, profile, definition, i... |

composer.json

@@ -84,5 +84,5 @@
             "/tests"
         ]
     },
-    "version": "0.1.48"
+    "version": "0.1.49"
 }

package.json

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

specs/openapi.json

@@ -13,15 +13,19 @@
 use Saloon\Http\Request;
 
 /**
- * Daily horoscope by zodiac sign - Transit-based forecast with house activations
+ * Daily horoscope by zodiac sign - Transit-based editorial columns
  *
- * Get the daily horoscope for any zodiac sign. Forecast is generated from real-time planetary
- * transits using whole-sign house positions, so every sign receives unique content. Returns
- * love, career, health, finance, overview with active transits, Moon sign, Moon phase, energy
- * rating, lucky number, lucky color, and compatible signs. Content is fixed for a given date
- * and rolls over at midnight, by default UTC. Pass date for editorial scheduling, or timezone
- * to roll over on a local clock. Daily horoscope API, zodiac forecast, sun sign horoscope,
- * astrology prediction.
+ * A publish-ready column for any zodiac sign, built from the dated transits over it and
+ * returned with those events for fact-checking. The reading names the aspects, sign ingresses,
+ * lunations and retrograde stations driving it and reads each into the whole-sign houses of
+ * that sign, so every sign gets different content rather than one blurb reused twelve times.
+ * Alongside the column come overview, love, career, health, finance and advice, the active
+ * transits, Moon sign and phase, an energy rating, lucky number and color, and compatible
+ * signs. No language model is involved, so a given sign and date always returns the same text
+ * and a piece scheduled months ahead is the piece that runs. Content rolls over at midnight,
+ * by default UTC. Pass date for editorial scheduling, or timezone to roll over on a local
+ * clock. Available in eight languages. Daily horoscope API, zodiac forecast, sun sign
+ * horoscope, astrology prediction.
  *
  * GET /astrology/horoscope/{sign}/daily
  */

src/Generated/Requests/GetDailyHoroscopeRequest.php

@@ -13,13 +13,16 @@
 use Saloon\Http\Request;
 
 /**
- * Monthly horoscope by zodiac sign - 30-day transit forecast with key dates
+ * Monthly horoscope by zodiac sign - Editorial column with key dates
  *
- * Get monthly horoscope for any zodiac sign with sign-specific week-by-week breakdown and real
- * lunar phase key dates. Based on planetary transits with house activations unique to each
- * sign, covering love, career, health, and finance for the entire month. Key dates include
- * actual New Moon, Full Moon, and retrograde dates from ephemeris calculations. Pass any date
- * inside a month to retrieve that month, or timezone to roll over on a local clock. Monthly
+ * A month-long column for any zodiac sign, plus a week-by-week breakdown and dated key dates a
+ * calendar page renders directly. The column names every aspect, ingress, lunation and station
+ * of the month and reads each into the whole-sign houses of that sign, and those events come
+ * back beside the prose with their exact instants, so a piece can be checked against NASA JPL
+ * Horizons or the US Naval Observatory before it runs. Key dates are the real New Moon, Full
+ * Moon and retrograde instants, never approximations. Alongside the column come overview,
+ * love, career, health, finance and advice. Pass any date inside a month to retrieve that
+ * month, or timezone to roll over on a local clock. Available in eight languages. Monthly
  * horoscope API, zodiac monthly forecast, astrology monthly prediction.
  *
  * GET /astrology/horoscope/{sign}/monthly

src/Generated/Requests/GetMonthlyHoroscopeRequest.php

@@ -13,13 +13,16 @@
 use Saloon\Http\Request;
 
 /**
- * Weekly horoscope by zodiac sign - 7-day transit forecast
+ * Weekly horoscope by zodiac sign - Seven-day editorial column
  *
- * Get weekly horoscope for any zodiac sign. Forecast covers a full Monday to Sunday period
- * based on planetary transits with house-based content unique to each sign, with love, career,
- * health, finance guidance plus lucky days, lucky numbers, and compatible signs. Pass any date
- * inside a week to retrieve that week, or timezone to roll over on a local clock. Weekly
- * horoscope API, zodiac weekly forecast, astrology weekly prediction.
+ * A Monday to Sunday column for any zodiac sign, naming the transits that perfect during the
+ * week and the days they fall on. Each event is read into the whole-sign houses of that sign,
+ * so content is unique per sign, and the dated events come back beside the prose so an editor
+ * can check a piece before it runs. Alongside the column come overview, love, career, health,
+ * finance and advice, plus lucky days, lucky numbers and compatible signs. No language model
+ * is involved, so the same sign and week always returns the same text. Pass any date inside a
+ * week to retrieve that week, or timezone to roll over on a local clock. Available in eight
+ * languages. Weekly horoscope API, zodiac weekly forecast, astrology weekly prediction.
  *
  * GET /astrology/horoscope/{sign}/weekly
  */

src/Generated/Requests/GetWeeklyHoroscopeRequest.php

@@ -0,0 +1,66 @@
+<?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;
+
+/**
+ * Yearly horoscope by zodiac sign - Year ahead forecast with themes, key periods, eclipses and
+ * retrogrades
+ *
+ * Get the year ahead for any zodiac sign, as a long-form column plus the structured arrays a
+ * year-ahead page is built from: the slow-body themes that set the backdrop, a dated key
+ * period for each of the twelve houses, the best month for love, career, health and finance,
+ * and every eclipse and every retrograde and direct station with the house it falls in for
+ * this sign. Love, career, health, finance and advice cover the whole year, and the dated
+ * events behind the copy come back beside it so an editor can check the piece before it runs.
+ * Omit the year for the one in progress, or pass any year from 1900 to 2100 to build an
+ * archive or a forecast ahead of time. Yearly horoscope API, year ahead astrology, annual
+ * zodiac forecast, eclipse and retrograde calendar.
+ *
+ * GET /astrology/horoscope/{sign}/yearly
+ */
+class GetYearlyHoroscopeRequest extends Request
+{
+    protected Method $method = Method::GET;
+
+    public function __construct(
+        public readonly string $sign,
+        public readonly ?string $lang = null,
+        public readonly ?string $timezone = null,
+        public readonly ?float $year = null,
+    ) {
+    }
+
+    public function resolveEndpoint(): string
+    {
+        return "/astrology/horoscope/{$this->sign}/yearly";
+    }
+
+    /**
+     * @return array<string, mixed>
+     */
+    protected function defaultQuery(): array
+    {
+        $query = [];
+        if ($this->lang !== null) {
+            $query['lang'] = $this->lang;
+        }
+        if ($this->timezone !== null) {
+            $query['timezone'] = $this->timezone;
+        }
+        if ($this->year !== null) {
+            $query['year'] = $this->year;
+        }
+
+        return $query;
+    }
+}

src/Generated/Requests/GetYearlyHoroscopeRequest.php

@@ -12,8 +12,8 @@
 use RoxyAPI\Sdk\Generated\Resources\BaseResource;
 
 /**
- * Western astrology API for natal birth charts, daily, weekly, and monthly horoscopes with
- * unique content per sign, syn...
+ * Western astrology API for natal birth charts, daily, weekly, monthly, and yearly horoscopes
+ * with unique content per s...
  *
  * Accessed via $roxy->astrology.
  */
@@ -1301,15 +1301,19 @@ public function getCurrentMoonPhase(
     }
 
     /**
-     * Daily horoscope by zodiac sign - Transit-based forecast with house activations
-     *
-     * Get the daily horoscope for any zodiac sign. Forecast is generated from real-time planetary
-     * transits using whole-sign house positions, so every sign receives unique content. Returns
-     * love, career, health, finance, overview with active transits, Moon sign, Moon phase, energy
-     * rating, lucky number, lucky color, and compatible signs. Content is fixed for a given date
-     * and rolls over at midnight, by default UTC. Pass date for editorial scheduling, or timezone
-     * to roll over on a local clock. Daily horoscope API, zodiac forecast, sun sign horoscope,
-     * astrology prediction.
+     * Daily horoscope by zodiac sign - Transit-based editorial columns
+     *
+     * A publish-ready column for any zodiac sign, built from the dated transits over it and
+     * returned with those events for fact-checking. The reading names the aspects, sign ingresses,
+     * lunations and retrograde stations driving it and reads each into the whole-sign houses of
+     * that sign, so every sign gets different content rather than one blurb reused twelve times.
+     * Alongside the column come overview, love, career, health, finance and advice, the active
+     * transits, Moon sign and phase, an energy rating, lucky number and color, and compatible
+     * signs. No language model is involved, so a given sign and date always returns the same text
+     * and a piece scheduled months ahead is the piece that runs. Content rolls over at midnight,
+     * by default UTC. Pass date for editorial scheduling, or timezone to roll over on a local
+     * clock. Available in eight languages. Daily horoscope API, zodiac forecast, sun sign
+     * horoscope, astrology prediction.
      *
      * GET /astrology/horoscope/{sign}/daily
      *
@@ -1403,13 +1407,16 @@ public function getMonthlyDeclinationParallels(
     }
 
     /**
-     * Monthly horoscope by zodiac sign - 30-day transit forecast with key dates
-     *
-     * Get monthly horoscope for any zodiac sign with sign-specific week-by-week breakdown and real
-     * lunar phase key dates. Based on planetary transits with house activations unique to each
-     * sign, covering love, career, health, and finance for the entire month. Key dates include
-     * actual New Moon, Full Moon, and retrograde dates from ephemeris calculations. Pass any date
-     * inside a month to retrieve that month, or timezone to roll over on a local clock. Monthly
+     * Monthly horoscope by zodiac sign - Editorial column with key dates
+     *
+     * A month-long column for any zodiac sign, plus a week-by-week breakdown and dated key dates a
+     * calendar page renders directly. The column names every aspect, ingress, lunation and station
+     * of the month and reads each into the whole-sign houses of that sign, and those events come
+     * back beside the prose with their exact instants, so a piece can be checked against NASA JPL
+     * Horizons or the US Naval Observatory before it runs. Key dates are the real New Moon, Full
+     * Moon and retrograde instants, never approximations. Alongside the column come overview,
+     * love, career, health, finance and advice. Pass any date inside a month to retrieve that
+     * month, or timezone to roll over on a local clock. Available in eight languages. Monthly
      * horoscope API, zodiac monthly forecast, astrology monthly prediction.
      *
      * GET /astrology/horoscope/{sign}/monthly
@@ -1783,13 +1790,16 @@ public function getUpcomingMoonPhases(
     }
 
     /**
-     * Weekly horoscope by zodiac sign - 7-day transit forecast
+     * Weekly horoscope by zodiac sign - Seven-day editorial column
      *
-     * Get weekly horoscope for any zodiac sign. Forecast covers a full Monday to Sunday period
-     * based on planetary transits with house-based content unique to each sign, with love, career,
-     * health, finance guidance plus lucky days, lucky numbers, and compatible signs. Pass any date
-     * inside a week to retrieve that week, or timezone to roll over on a local clock. Weekly
-     * horoscope API, zodiac weekly forecast, astrology weekly prediction.
+     * A Monday to Sunday column for any zodiac sign, naming the transits that perfect during the
+     * week and the days they fall on. Each event is read into the whole-sign houses of that sign,
+     * so content is unique per sign, and the dated events come back beside the prose so an editor
+     * can check a piece before it runs. Alongside the column come overview, love, career, health,
+     * finance and advice, plus lucky days, lucky numbers and compatible signs. No language model
+     * is involved, so the same sign and week always returns the same text. Pass any date inside a
+     * week to retrieve that week, or timezone to roll over on a local clock. Available in eight
+     * languages. Weekly horoscope API, zodiac weekly forecast, astrology weekly prediction.
      *
      * GET /astrology/horoscope/{sign}/weekly
      *
@@ -1823,6 +1833,52 @@ public function getWeeklyHoroscope(
         return $this->callRequest($request);
     }
 
+    /**
+     * Yearly horoscope by zodiac sign - Year ahead forecast with themes, key periods, eclipses and
+     * retrogrades
+     *
+     * Get the year ahead for any zodiac sign, as a long-form column plus the structured arrays a
+     * year-ahead page is built from: the slow-body themes that set the backdrop, a dated key
+     * period for each of the twelve houses, the best month for love, career, health and finance,
+     * and every eclipse and every retrograde and direct station with the house it falls in for
+     * this sign. Love, career, health, finance and advice cover the whole year, and the dated
+     * events behind the copy come back beside it so an editor can check the piece before it runs.
+     * Omit the year for the one in progress, or pass any year from 1900 to 2100 to build an
+     * archive or a forecast ahead of time. Yearly horoscope API, year ahead astrology, annual
+     * zodiac forecast, eclipse and retrograde calendar.
+     *
+     * GET /astrology/horoscope/{sign}/yearly
+     *
+     * @param string $sign
+     *   Zodiac sign, case-insensitive (e.g., aries, Aries, ARIES all work).
+     * @param string|null $lang
+     *   Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant.
+     *   Defaults to en. Coverage varies by domain, and a field with no translation in the requested
+     *   language returns English.
+     * @param string|null $timezone
+     *   Selects which year counts as current when year is omitted. Defaults to UTC, so the forecast
+     *   rolls over at 00:00 UTC on January 1. Pass the timezone of the end user to roll over on
+     *   their local clock instead. Ignored when year is set. Accepts an IANA name (e.g.
+     *   "America/New_York"), decimal hours (e.g. 5.5 for IST), or a fixed UTC offset (e.g.
+     *   "-05:00").
+     * @param float|null $year
+     *   Calendar year to forecast, 1900 to 2100. Defaults to the current year in the timezone
+     *   parameter.
+     *
+     * @return array<string, mixed>
+     */
+    public function getYearlyHoroscope(
+        string $sign,
+        ?string $lang = null,
+        ?string $timezone = null,
+        ?float $year = null
+    ): array
+    {
+        $request = new \RoxyAPI\Sdk\Generated\Requests\GetYearlyHoroscopeRequest(sign: $sign, lang: $lang, timezone: $timezone, year: $year);
+
+        return $this->callRequest($request);
+    }
+
     /**
      * Get zodiac sign details - Complete astrology sign profile with personality traits
      *