@astroway/sdk 1.2.0 → 1.3.0

package/dist/types.generated.d.ts

@@ -655,7 +655,7 @@ export interface paths {
         /**
          * Vedic Divisional Chart (DEPRECATED — use /vedic/varga/{D}<*>)
          * @deprecated
-         * @description DEPRECATED in v2.0.0 — moved to dedicated per-varga endpoints `/vedic/varga/{D1..D60}` for OpenAPI/SDK ergonomics. Generic endpoint kept for 6-month sunset. Calculate a Vedic divisional (varga) chart using sidereal zodiac. Supported vargas: D1–D60 (e.g. D9 Navamsha).
+         * @description DEPRECATED — moved to dedicated per-varga endpoints `/vedic/varga/{D1..D60}` for OpenAPI/SDK ergonomics. This generic endpoint still works and stays live until its 2027-06-15 sunset (12-month, per the /v1 stability policy), then will be removed — migrate to `/vedic/varga/{D}`. Calculate a Vedic divisional (varga) chart using sidereal zodiac. Supported vargas: D1–D60 (e.g. D9 Navamsha).
          */
         post: operations["vedic-divisional"];
         delete?: never;
@@ -7234,8 +7234,9 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * I Ching Hexagram
-         * @description Return the I Ching hexagram corresponding to each planet's gate in the Human Design wheel.
+         * I Ching Hexagram (DEPRECATED — use /iching/throw-coins)
+         * @deprecated
+         * @description DEPRECATED — legacy un-namespaced random hexagram cast. Superseded by the /iching/* namespace: `/iching/throw-coins` (seeded + reproducible), `/iching/by-question`, `/iching/with-changing-lines`, `/iching/daily`, `/iching/lookup/{n}` — all on the Wilhelm-Baynes hexagram set. Still works until its 2027-06-16 sunset, then removed. Casts a single I Ching hexagram (input ignored).
          */
         post: operations["iching"];
         delete?: never;
@@ -7254,9 +7255,9 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Djamaspa (DEPRECATED — RED quality, slated for v2.0 sunset)
+         * Djamaspa (DEPRECATED — RED quality, sunset 2027-06-15)
          * @deprecated
-         * @description DEPRECATED in v2.0.0 — RED quality (oral Zoroastrian tradition, scattered manuscripts, no canonical reference). Slated for sunset 6 months after v2.0.0 release. Migrate to broader /reference endpoints or remove dependency. Calculate Djamaspa planetary positions for date.
+         * @description DEPRECATED — RED quality (oral Zoroastrian tradition, scattered manuscripts, no canonical reference). Still works until its 2027-06-15 sunset (12-month, per the /v1 stability policy), then will be removed. Migrate to broader /reference endpoints or remove the dependency. Calculate Djamaspa planetary positions for date.
          */
         post: operations["djamaspa"];
         delete?: never;
@@ -10829,6 +10830,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/reports/history": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List Recent Report Exports
+         * @description List the calling key's most recently generated PDF reports — type, byte size, page count, language, created/expiry timestamps and a `url`. Re-fetch a report link within its 24h validity window, or surface recent exports in a dashboard. PDFs are purged after 24h, so older items return `expired: true` with a now-dead URL. Free to call. Query `?limit=` (1–50, default 10).
+         */
+        get: operations["reports_history_get"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/reports/ai/natal-narrative": {
         parameters: {
             query?: never;
@@ -14313,6 +14334,480 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/public/horoscope/daily": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Daily Horoscope (public, no key)
+         * @description Sun-sign daily horoscope. No authentication, IP-rate-limited (30/hr). Cached per (sign, date, language); every response carries the `_footer` watermark.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Zodiac sun sign. */
+                    sign: "aries" | "taurus" | "gemini" | "cancer" | "leo" | "virgo" | "libra" | "scorpio" | "sagittarius" | "capricorn" | "aquarius" | "pisces";
+                    /** @description Calendar date `YYYY-MM-DD` (UTC). Defaults to today. */
+                    date?: string;
+                };
+                header?: {
+                    /** @description BCP-47 language (e.g. `uk`, `en`, `de`) — sets the horoscope text language. `?lang=` also works. */
+                    "Accept-Language"?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "ok": true,
+                         *       "data": {
+                         *         "sign": "aries",
+                         *         "date": "2026-06-14",
+                         *         "period": "daily",
+                         *         "horoscope": "## …\n…",
+                         *         "disclaimer": "For entertainment purposes only.",
+                         *         "model": "groq/llama-3.3-70b",
+                         *         "language": "en"
+                         *       },
+                         *       "_footer": "Powered by astroway.api — get your own key at https://api.astroway.info"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Invalid sign or date */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "ok": false,
+                         *       "error": {
+                         *         "code": "INVALID_SIGN",
+                         *         "message": "sign must be one of the 12 zodiac signs"
+                         *       }
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/public/horoscope/weekly": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Weekly Horoscope (public, no key)
+         * @description Sun-sign weekly horoscope. The cache key anchors to the week's Monday, so any day in the week returns the same reading (and a finite number of generations per week). `_footer` watermark.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Zodiac sun sign. */
+                    sign: "aries" | "taurus" | "gemini" | "cancer" | "leo" | "virgo" | "libra" | "scorpio" | "sagittarius" | "capricorn" | "aquarius" | "pisces";
+                    /** @description Calendar date `YYYY-MM-DD` (UTC). Defaults to today. */
+                    date?: string;
+                };
+                header?: {
+                    /** @description BCP-47 language (e.g. `uk`, `en`, `de`) — sets the horoscope text language. `?lang=` also works. */
+                    "Accept-Language"?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "ok": true,
+                         *       "data": {
+                         *         "sign": "aries",
+                         *         "date": "2026-06-08",
+                         *         "period": "weekly",
+                         *         "horoscope": "## …\n…",
+                         *         "disclaimer": "For entertainment purposes only.",
+                         *         "model": "groq/llama-3.3-70b",
+                         *         "language": "en"
+                         *       },
+                         *       "_footer": "Powered by astroway.api — get your own key at https://api.astroway.info"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Invalid sign or date */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "ok": false,
+                         *       "error": {
+                         *         "code": "INVALID_SIGN",
+                         *         "message": "sign must be one of the 12 zodiac signs"
+                         *       }
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/public/horoscope/monthly": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Monthly Horoscope (public, no key)
+         * @description Sun-sign monthly horoscope. The cache key anchors to the 1st of the month. `_footer` watermark.
+         */
+        get: {
+            parameters: {
+                query: {
+                    /** @description Zodiac sun sign. */
+                    sign: "aries" | "taurus" | "gemini" | "cancer" | "leo" | "virgo" | "libra" | "scorpio" | "sagittarius" | "capricorn" | "aquarius" | "pisces";
+                    /** @description Calendar date `YYYY-MM-DD` (UTC). Defaults to today. */
+                    date?: string;
+                };
+                header?: {
+                    /** @description BCP-47 language (e.g. `uk`, `en`, `de`) — sets the horoscope text language. `?lang=` also works. */
+                    "Accept-Language"?: string;
+                };
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "ok": true,
+                         *       "data": {
+                         *         "sign": "aries",
+                         *         "date": "2026-06-01",
+                         *         "period": "monthly",
+                         *         "horoscope": "## …\n…",
+                         *         "disclaimer": "For entertainment purposes only.",
+                         *         "model": "groq/llama-3.3-70b",
+                         *         "language": "en"
+                         *       },
+                         *       "_footer": "Powered by astroway.api — get your own key at https://api.astroway.info"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Invalid sign or date */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "ok": false,
+                         *       "error": {
+                         *         "code": "INVALID_SIGN",
+                         *         "message": "sign must be one of the 12 zodiac signs"
+                         *       }
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/public/tarot/daily": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Tarot Card of the Day (public, no key)
+         * @description Deterministic Rider–Waite–Smith single card, seeded by date — the same date always yields the same card. No AI. `_footer` watermark.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Calendar date `YYYY-MM-DD` (UTC). Defaults to today. */
+                    date?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "ok": true,
+                         *       "data": {
+                         *         "date": "2026-06-14",
+                         *         "spread": "single-card",
+                         *         "seed": 1734220800,
+                         *         "drawn": [
+                         *           {
+                         *             "position": "The card",
+                         *             "card": "The Star",
+                         *             "reversed": false
+                         *           }
+                         *         ]
+                         *       },
+                         *       "_footer": "Powered by astroway.api — get your own key at https://api.astroway.info"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Invalid sign or date */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "ok": false,
+                         *       "error": {
+                         *         "code": "INVALID_SIGN",
+                         *         "message": "sign must be one of the 12 zodiac signs"
+                         *       }
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/public/moon-phase": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Moon Phase (public, no key)
+         * @description Geocentric moon phase for a date (computed at noon UTC) — deterministic, no AI, no birth data. `_footer` watermark.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Calendar date `YYYY-MM-DD` (UTC). Defaults to today. */
+                    date?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "ok": true,
+                         *       "data": {
+                         *         "date": "2026-06-14",
+                         *         "phase": 0.006,
+                         *         "phaseName": "New Moon",
+                         *         "majorPhase": "new_moon",
+                         *         "illuminationPercent": 0.6,
+                         *         "elongationDeg": 8.9,
+                         *         "ageDays": 0.73,
+                         *         "waxing": true,
+                         *         "moonSign": "Gemini",
+                         *         "sunSign": "Gemini"
+                         *       },
+                         *       "_footer": "Powered by astroway.api — get your own key at https://api.astroway.info"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Invalid sign or date */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "ok": false,
+                         *       "error": {
+                         *         "code": "INVALID_SIGN",
+                         *         "message": "sign must be one of the 12 zodiac signs"
+                         *       }
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/public/planet-of-day": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Planet of the Day (public, no key)
+         * @description Traditional (Chaldean) planetary ruler of the weekday — Sun=Sunday, Moon=Monday, …, Saturn=Saturday. Deterministic, no AI. `_footer` watermark.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Calendar date `YYYY-MM-DD` (UTC). Defaults to today. */
+                    date?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description OK */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "ok": true,
+                         *       "data": {
+                         *         "date": "2026-06-14",
+                         *         "weekday": "Sunday",
+                         *         "planet": "Sun",
+                         *         "glyph": "☉",
+                         *         "themes": [
+                         *           "vitality",
+                         *           "success",
+                         *           "leadership",
+                         *           "self-expression"
+                         *         ]
+                         *       },
+                         *       "_footer": "Powered by astroway.api — get your own key at https://api.astroway.info"
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+                /** @description Invalid sign or date */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        /**
+                         * @example {
+                         *       "ok": false,
+                         *       "error": {
+                         *         "code": "INVALID_SIGN",
+                         *         "message": "sign must be one of the 12 zodiac signs"
+                         *       }
+                         *     }
+                         */
+                        "application/json": unknown;
+                    };
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
 }
 export type webhooks = Record<string, never>;
 export interface components {
@@ -14914,7 +15409,9 @@ export interface components {
             textPrimaryColor?: string;
             textSecondaryColor?: string;
             backgroundColor?: string;
+            /** @description Accent colour — used for section heading text and inline emphasis. */
             themeColor?: string;
+            /** @description Colour of the divider rule under each section heading (not the heading text — that is themeColor). */
             headingColor?: string;
             footerText?: string;
             /** @enum {string} */
@@ -14949,7 +15446,9 @@ export interface components {
                 textPrimaryColor?: string;
                 textSecondaryColor?: string;
                 backgroundColor?: string;
+                /** @description Accent colour — used for section heading text and inline emphasis. */
                 themeColor?: string;
+                /** @description Colour of the divider rule under each section heading (not the heading text — that is themeColor). */
                 headingColor?: string;
                 footerText?: string;
                 /** @enum {string} */
@@ -14976,7 +15475,9 @@ export interface components {
                 textPrimaryColor?: string;
                 textSecondaryColor?: string;
                 backgroundColor?: string;
+                /** @description Accent colour — used for section heading text and inline emphasis. */
                 themeColor?: string;
+                /** @description Colour of the divider rule under each section heading (not the heading text — that is themeColor). */
                 headingColor?: string;
                 footerText?: string;
                 /** @enum {string} */
@@ -15290,7 +15791,9 @@ export interface components {
                 textPrimaryColor?: string;
                 textSecondaryColor?: string;
                 backgroundColor?: string;
+                /** @description Accent colour — used for section heading text and inline emphasis. */
                 themeColor?: string;
+                /** @description Colour of the divider rule under each section heading (not the heading text — that is themeColor). */
                 headingColor?: string;
                 footerText?: string;
                 /** @enum {string} */
@@ -15339,7 +15842,9 @@ export interface components {
                 textPrimaryColor?: string;
                 textSecondaryColor?: string;
                 backgroundColor?: string;
+                /** @description Accent colour — used for section heading text and inline emphasis. */
                 themeColor?: string;
+                /** @description Colour of the divider rule under each section heading (not the heading text — that is themeColor). */
                 headingColor?: string;
                 footerText?: string;
                 /** @enum {string} */
@@ -15440,7 +15945,9 @@ export interface components {
                 textPrimaryColor?: string;
                 textSecondaryColor?: string;
                 backgroundColor?: string;
+                /** @description Accent colour — used for section heading text and inline emphasis. */
                 themeColor?: string;
+                /** @description Colour of the divider rule under each section heading (not the heading text — that is themeColor). */
                 headingColor?: string;
                 footerText?: string;
                 /** @enum {string} */
@@ -15503,7 +16010,9 @@ export interface components {
                 textPrimaryColor?: string;
                 textSecondaryColor?: string;
                 backgroundColor?: string;
+                /** @description Accent colour — used for section heading text and inline emphasis. */
                 themeColor?: string;
+                /** @description Colour of the divider rule under each section heading (not the heading text — that is themeColor). */
                 headingColor?: string;
                 footerText?: string;
                 /** @enum {string} */
@@ -48085,20 +48594,7 @@ export interface operations {
             path?: never;
             cookie?: never;
         };
-        requestBody: {
-            content: {
-                /**
-                 * @example {
-                 *       "date": "1990-05-15",
-                 *       "time": "14:30:00",
-                 *       "timezoneOffset": 3,
-                 *       "latitude": 50.45,
-                 *       "longitude": 30.52
-                 *     }
-                 */
-                "application/json": Record<string, never>;
-            };
-        };
+        requestBody?: never;
         responses: {
             /** @description Successful calculation */
             200: {
@@ -48110,15 +48606,14 @@ export interface operations {
                         /** @example true */
                         ok?: boolean;
                         data?: {
-                            planets?: {
-                                planet?: string;
-                                gate?: number;
-                                hexagram?: number;
-                                name?: string;
-                                judgment?: string;
-                                line?: number;
-                                lineText?: string;
+                            number?: number;
+                            name?: string;
+                            lines?: {
+                                value?: number;
+                                isChanging?: boolean;
                             }[];
+                            upper?: string;
+                            lower?: string;
                         };
                     };
                 };
@@ -65306,6 +65801,108 @@ export interface operations {
             };
         };
     };
+    reports_history_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful calculation */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "ok": true,
+                     *       "data": {
+                     *         "items": [
+                     *           {
+                     *             "id": 42,
+                     *             "report_type": "natal",
+                     *             "storage_key": "reports/abc-natal.pdf",
+                     *             "url": "https://api.astroway.info/reports/abc-natal.pdf",
+                     *             "byte_length": 124350,
+                     *             "page_count": 1,
+                     *             "language": "uk",
+                     *             "created_at": "2026-06-10T16:00:00Z",
+                     *             "expires_at": "2026-06-11T16:00:00Z",
+                     *             "expired": false
+                     *           }
+                     *         ],
+                     *         "count": 1
+                     *       }
+                     *     }
+                     */
+                    "application/json": {
+                        /** @example true */
+                        ok?: boolean;
+                        data?: {
+                            items?: {
+                                id?: number;
+                                report_type?: string;
+                                storage_key?: string;
+                                url?: string;
+                                byte_length?: number;
+                                page_count?: number;
+                                language?: string;
+                                created_at?: string;
+                                expires_at?: string;
+                                expired?: boolean;
+                            }[];
+                            count?: number;
+                        };
+                    };
+                };
+            };
+            /** @description Validation error */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "ok": false,
+                     *       "error": {
+                     *         "code": "INVALID_INPUT",
+                     *         "message": "Validation failed: date: Date must be YYYY-MM-DD",
+                     *         "details": [
+                     *           {
+                     *             "path": "date",
+                     *             "message": "Date must be YYYY-MM-DD"
+                     *           }
+                     *         ]
+                     *       }
+                     *     }
+                     */
+                    "application/json": unknown;
+                };
+            };
+            /** @description Missing or invalid API key */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    /**
+                     * @example {
+                     *       "ok": false,
+                     *       "error": {
+                     *         "code": "INVALID_API_KEY",
+                     *         "message": "Invalid API key"
+                     *       }
+                     *     }
+                     */
+                    "application/json": unknown;
+                };
+            };
+        };
+    };
     "reports_ai_natal-narrative": {
         parameters: {
             query?: never;