@roxyapi/sdk 1.2.69 → 1.2.70

package/AGENTS.md

@@ -45,6 +45,8 @@ Type `roxy.` to see all available namespaces. Type `roxy.{domain}.` to see every
 | `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... |
+| `roxy.chineseAstrology` | Calculate BaZi Four Pillars charts, Chinese zodiac signs, and the Chinese lunisolar calendar from any birth moment: y... |
+| `roxy.fengShui` | Compute classical feng shui from one API: Xuan Kong flying star natal charts for any of the nine periods and 24 mount... |
 | `roxy.numerology` | Numerology API to calculate life path, expression, soul urge, personality, and maturity numbers, with Pinnacle and Ch... |
 | `roxy.tarot` | Tarot reading API with the complete 78-card Rider-Waite-Smith deck and card meanings for love, career, health, and sp... |
 | `roxy.biorhythm` | The most complete biorhythm API: 10 cycle types across 3 primary (physical, emotional, intellectual), 4 secondary (in... |

package/README.md

@@ -89,6 +89,8 @@ const { latitude, longitude, timezone } = data.cities[0];
 | `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... |
+| `roxy.chineseAstrology` | Calculate BaZi Four Pillars charts, Chinese zodiac signs, and the Chinese lunisolar calendar from any birth moment: y... |
+| `roxy.fengShui` | Compute classical feng shui from one API: Xuan Kong flying star natal charts for any of the nine periods and 24 mount... |
 | `roxy.numerology` | Numerology API to calculate life path, expression, soul urge, personality, and maturity numbers, with Pinnacle and Ch... |
 | `roxy.tarot` | Tarot reading API with the complete 78-card Rider-Waite-Smith deck and card meanings for love, career, health, and sp... |
 | `roxy.biorhythm` | The most complete biorhythm API: 10 cycle types across 3 primary (physical, emotional, intellectual), 4 secondary (in... |

package/dist/factory.cjs

@@ -23,8 +23,10 @@ __export(factory_exports, {
   AngelNumbers: () => AngelNumbers,
   Astrology: () => Astrology,
   Biorhythm: () => Biorhythm,
+  ChineseAstrology: () => ChineseAstrology,
   Crystals: () => Crystals,
   Dreams: () => Dreams,
+  FengShui: () => FengShui,
   Forecast: () => Forecast,
   HumanDesign: () => HumanDesign,
   Iching: () => Iching,
@@ -1122,7 +1124,7 @@ var Astrology = class extends HeyApiClient {
   /**
    * Transit Aspects - Detailed transit-to-natal aspect analysis with interpretations
    *
-   * Calculate all transit-to-natal aspects with detailed interpretations, strength ratings, and timing guidance. Compares current (or future) planetary positions against your natal chart to identify active transits. Returns aspect type, orb, applying/separating status, narrative interpretation, impact rating, and practical guidance for each transit. Supports planet and aspect-type filtering. More detailed than the /transits endpoint — includes AI-friendly interpretation fields. Transit aspects API, transit-to-natal analysis, predictive astrology, personalized transit forecast.
+   * Calculate all transit-to-natal aspects with detailed interpretations, strength ratings, and timing guidance. Compares current (or future) planetary positions against your natal chart to identify active transits. Returns aspect type, orb, applying/separating status, narrative interpretation, impact rating, and practical guidance for each transit. Supports planet and aspect-type filtering. More detailed than the /transits endpoint, adding AI-friendly interpretation fields. Transit aspects API, transit-to-natal analysis, predictive astrology, personalized transit forecast.
    */
   calculateTransitAspects(options) {
     return (options?.client ?? this.client).post({
@@ -2558,6 +2560,378 @@ var HumanDesign = class extends HeyApiClient {
     });
   }
 };
+var ChineseAstrology = class extends HeyApiClient {
+  /**
+   * Generate BaZi chart - Four Pillars of Destiny calculator API
+   *
+   * Calculate a complete BaZi chart, the Four Pillars of Destiny, from a birth moment. Returns the year, month, day and hour pillars with every Heavenly Stem and Earthly Branch, the stems hidden inside each branch, the Ten God relation each one holds to the Day Master, the Na Yin sound element of each pair, the five-element balance across the chart, and the combinations and clashes running between the pillars. The day boundary, year boundary and hour clock are all selectable and the applied conventions come back on every response, so a chart is self-describing. Built for astrology apps, matchmaking services, and agents that need a Four Pillars reading they can reproduce.
+   */
+  generateBaziChart(options) {
+    return (options?.client ?? this.client).post({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/chinese-astrology/bazi/chart",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options?.headers
+      }
+    });
+  }
+  /**
+   * Calculate luck pillars - BaZi Da Yun ten-year cycle API
+   *
+   * Calculate the da yun luck pillars, the ten-year periods a BaZi chart walks through after birth. Returns the direction the sequence runs, the age it begins at with the day count behind that age, each ten-year pillar with the Ten God relation its stem holds to the natal Day Master, and an optional year-by-year annual overlay. Direction follows the classical rule: a male born in a yang-stem year and a female born in a yin-stem year run forward through the sexagenary cycle, the other two combinations run backward. Built for astrology apps, life-timing features, and agents that need a reproducible forecast spine.
+   */
+  calculateLuckPillars(options) {
+    return (options?.client ?? this.client).post({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/chinese-astrology/bazi/luck-pillars",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options?.headers
+      }
+    });
+  }
+  /**
+   * Calculate Day Master strength - BaZi favorable element API
+   *
+   * Assess how well the Day Master is supported by the rest of a BaZi chart, and which of the five elements help it. Uses the classical three-factor method: whether the birth month season backs the Day Master element, whether any branch stores a root for it, and whether the other stems help or spend it. Returns the verdict, an auditable score with each factor contribution, the seasonal state, the root count, the element headcount, and the favorable and unfavorable element lists that follow from the verdict. Built for chart readers, remedy features, and agents that need the usable half of a Four Pillars reading.
+   */
+  calculateDayMasterStrength(options) {
+    return (options?.client ?? this.client).post({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/chinese-astrology/bazi/day-master",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options?.headers
+      }
+    });
+  }
+  /**
+   * Calculate BaZi compatibility - Four Pillars matchmaking API
+   *
+   * Compare two BaZi charts pillar by pillar. Returns both resolved charts, how the two Day Masters stand to each other on the five-phase cycle, and every combination, clash, harm and punishment that crosses between them, each naming the two positions it joins. A tallied score summarises the balance and the interaction list behind it is returned in full, so a caller that disagrees with the weighting can recompute its own. Built for matchmaking products, relationship features, and agents that need a defensible two-chart reading.
+   */
+  calculateBaziCompatibility(options) {
+    return (options?.client ?? this.client).post({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/chinese-astrology/bazi/compatibility",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options?.headers
+      }
+    });
+  }
+  /**
+   * Calculate BaZi annual forecast - Liu Nian yearly pillar API
+   *
+   * Read one Gregorian year against a natal BaZi chart. Returns the annual pillar for that year, the Ten God relation its stem holds to the natal Day Master, the same reading for the hidden stem of its branch, how the annual branch stands to the natal year branch including the ben ming nian return of the birth animal, and every combination, clash, harm and punishment the annual pillar forms with each of the four natal pillars. Built for yearly horoscope features, timing tools, and agents that need a year read against a specific chart rather than against an animal sign.
+   */
+  calculateAnnualForecast(options) {
+    return (options?.client ?? this.client).post({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/chinese-astrology/bazi/annual-forecast",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options?.headers
+      }
+    });
+  }
+  /**
+   * List the 12 Chinese zodiac animals - Sheng Xiao sign catalogue
+   *
+   * Retrieve all twelve Chinese zodiac animals in cycle order, from Rat through Pig. Each entry returns the machine id, the Chinese character and tone-marked pinyin for the animal, its Earthly Branch, the fixed Five Element phase and yin or yang polarity of that branch, and a set of trait keywords. Built for sign pickers, zodiac cards and compatibility widgets that need the whole set in one call.
+   */
+  listZodiacAnimals(options) {
+    return (options?.client ?? this.client).get({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/chinese-astrology/zodiac/animals",
+      ...options
+    });
+  }
+  /**
+   * Get one Chinese zodiac animal - Full sign profile with compatibility partners
+   *
+   * Retrieve the complete profile of one Chinese zodiac animal: character summary, strengths, weaknesses, trait keywords, the double-hour its Earthly Branch governs, and its five element variants with the Gregorian years that carry each one. Also returns the four classical branch relationships, the three-harmony trine it belongs to, its six-harmony secret friend, its clashing opposite and its harming partner. Built for sign detail pages and compatibility features.
+   */
+  getZodiacAnimal(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/chinese-astrology/zodiac/animals/{id}",
+      ...options
+    });
+  }
+  /**
+   * Find the Chinese zodiac animal for a birth date - Sheng Xiao calculator
+   *
+   * Resolve a birth date to its Chinese zodiac animal, the sexagenary year pillar behind it, and the Five Element phase of that year, so a 1990 birth returns Horse as a Metal Horse rather than merely a Horse. The year boundary is a request parameter because the two schools genuinely disagree for dates in January and early February, and the resolved convention is echoed back so the answer is self-describing. Built for sign lookups, onboarding forms and birthday features.
+   */
+  calculateZodiacAnimal(options) {
+    return (options.client ?? this.client).post({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/chinese-astrology/zodiac/sign",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  /**
+   * Chinese zodiac compatibility - Trine, six harmony, clash and harm analysis
+   *
+   * Score and explain the relationship between two Chinese zodiac animals from the classical branch relations rather than from a lookup table of opinions. Returns which of the six relations the pair stands in, a score out of 100, the phase the two branches combine into where they combine at all, and a composed reading with strengths, frictions and advice. The six relations are mutually exclusive by construction, so exactly one applies to any pair. Built for matchmaking features, relationship reports and compatibility widgets.
+   */
+  getZodiacCompatibility(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/chinese-astrology/zodiac/compatibility/{sign1}/{sign2}",
+      ...options
+    });
+  }
+  /**
+   * Daily Chinese zodiac reading - Day pillar forecast by animal sign
+   *
+   * Get the daily reading for one Chinese zodiac animal, built from the sexagenary day pillar rather than from a rotation of stock text. The day carries its own Earthly Branch, that branch stands in exactly one of six classical relations to the requested sign, and the reading is that relation applied to the sign temperament. Returns the day pillar, the relation, an energy rating, overview, love and career guidance, advice, and the sexagenary year in force with its Ben Ming Nian flag. Content is fixed for a given date and rolls over at midnight, by default UTC.
+   */
+  getDailyZodiacReading(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/chinese-astrology/zodiac/{id}/daily",
+      ...options
+    });
+  }
+  /**
+   * List the 24 solar terms - Jie Qi calendar API with exact instants
+   *
+   * Return all 24 solar terms of a year as astronomical instants rather than dates, each computed from the moment the sun reaches its exact apparent longitude at 15 degree steps. The year is the SOLAR year, which opens at Li Chun in early February, so Minor Cold and Major Cold, the last two terms, are dated in the January of the following Gregorian year. Every instant is returned twice, once in UTC and once at the UTC+8 reference meridian the Chinese calendar is defined on. Built for calendar apps, festival scheduling, and any BaZi feature that has to place a birth on the correct side of a term boundary.
+   */
+  listSolarTerms(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/chinese-astrology/calendar/solar-terms/{year}",
+      ...options
+    });
+  }
+  /**
+   * Convert lunar and Gregorian dates - Chinese lunisolar calendar API
+   *
+   * Convert a Gregorian date to the Chinese lunisolar calendar or convert a lunar date back, in one endpoint. The calendar is computed at the UTC+8 reference meridian with the month containing the winter solstice fixed as month 11 and the leap month placed as the first month of the cycle carrying no major solar term, so a lunar date is the same worldwide rather than shifting with the caller timezone. The response reports the length of the lunar month, whether the date sits in a leap month, and which month the year doubles if any. Built for festival calendars, birthday features that follow the lunar date, and any app that has to survive a leap month without shifting every date after it.
+   */
+  calculateLunarDate(options) {
+    return (options?.client ?? this.client).post({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/chinese-astrology/calendar/lunar-date",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options?.headers
+      }
+    });
+  }
+  /**
+   * Get the almanac for a day - Tong Shu API with day officers and mansions
+   *
+   * Return the full almanac reading of one day: its lunisolar date, the year, month and day pillars with their Na Yin, the day officer from the twelve jian chu sequence, the lunar mansion on duty, the zodiac animal the day clashes with, and the activities the officer favours or opposes. The day officer is the layer a printed almanac reaches its verdict from first, and the response says exactly what it rules on rather than reducing the day to a single score. The year and month pillars here are attributed by whole days, which is what an almanac prints: the day a solar term falls on belongs to the new period for its whole length, however late in the day the term arrives. Built for date pickers, daily calendar widgets, and wedding or opening date tools.
+   */
+  getAlmanacDay(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/chinese-astrology/calendar/day/{date}",
+      ...options
+    });
+  }
+  /**
+   * Get a month of almanac days - Chinese calendar month view API
+   *
+   * Return every day of one Gregorian month with its lunisolar date, its three pillars, its day officer, its lunar mansion and its clash animal, plus the solar terms that fall inside the month. This is the month view a calendar widget renders in one call rather than thirty one. Omit the year and month to get the month in progress. Built for calendar UIs, almanac pages, and planning tools that show a whole month at a glance.
+   */
+  getMonthlyAlmanac(options) {
+    return (options?.client ?? this.client).get({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/chinese-astrology/calendar/monthly",
+      ...options
+    });
+  }
+  /**
+   * Find auspicious days - Chinese date selection API for weddings and openings
+   *
+   * Search a date range for the days a chosen activity is favoured on, ranked by the jian chu day officer and filtered against a zodiac animal to protect. Every candidate day comes back with its officer, its pillars, its lunar date and the animal it clashes with, so a caller can show the reasoning rather than a bare verdict. The range is capped at 93 days, which is a quarter, because date selection is done inside a planning window rather than across a lifetime. Built for wedding planners, business opening tools, and moving and travel date pickers.
+   */
+  lookupAuspiciousDays(options) {
+    return (options.client ?? this.client).post({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/chinese-astrology/calendar/auspicious-days",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options.headers
+      }
+    });
+  }
+  /**
+   * List the five elements - Wu Xing API with generating and controlling cycles
+   *
+   * Return the five phases of Wu Xing with the Chinese character, the season and direction each governs, the Heavenly Stems and Earthly Branches that carry it, and both of the cycles that connect them. The generating cycle and the controlling cycle are returned as ordered rings as well as on each phase, so a caller can render either without deriving it. This is the one place the five phase vocabulary is defined: BaZi charts, Na Yin, zodiac element variants and every feng shui star reuse these identifiers rather than restating them.
+   */
+  listFiveElements(options) {
+    return (options?.client ?? this.client).get({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/chinese-astrology/elements",
+      ...options
+    });
+  }
+};
+var FengShui = class extends HeyApiClient {
+  /**
+   * Calculate Kua number - Feng shui personal direction calculator API
+   *
+   * Calculate the Kua number, also called the Ming Gua or life gua, from a birth date and sex. Returns the number, the east or west life group, the personal trigram, and all eight compass sectors classified from best to worst. The Chinese year is resolved at Li Chun by default, so an early February birthday is placed in the correct year rather than the calendar one, and the boundary that decided it is echoed back. Built for room and desk placement features, personalised feng shui reports, and any product that needs a favourable direction per person.
+   */
+  calculateKuaNumber(options) {
+    return (options?.client ?? this.client).post({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/feng-shui/kua",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options?.headers
+      }
+    });
+  }
+  /**
+   * Look up a Kua number - Eight Mansions reference API
+   *
+   * Look up the reference chart for one Kua number: its trigram, its east or west life group, and how it classifies all eight compass sectors. A pure reference endpoint with no birth data required, for building a lookup table or a picker. Number 5 is served for completeness and is never a computed result, because it belongs to the centre and has no direction of its own: a man whose formula gives 5 reads Kua 2 and a woman reads Kua 8, and the chart returned for 5 is therefore the Kua 2 chart.
+   */
+  getKuaNumber(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/feng-shui/kua/{number}",
+      ...options
+    });
+  }
+  /**
+   * Generate Eight Mansions map - Ba Zhai lucky direction API
+   *
+   * Build the full Eight Mansions (Ba Zhai) map for a person: all eight compass sectors classified into the four favourable stars, Sheng Chi, Tian Yi, Yan Nian and Fu Wei, and the four unfavourable ones, Huo Hai, Wu Gui, Liu Sha and Jue Ming. Sectors come back ordered best to worst with a composed reading each, plus the ranking that decides which affliction to accept when no favourable sector is reachable. Accepts a Kua number directly or derives one from a birth date and sex. Built for bed and desk placement tools, room-by-room reports and floor plan overlays.
+   */
+  generateEightMansions(options) {
+    return (options?.client ?? this.client).post({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/feng-shui/eight-mansions",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options?.headers
+      }
+    });
+  }
+  /**
+   * Generate flying star natal chart - Xuan Kong Fei Xing API
+   *
+   * Cast the Xuan Kong flying star natal chart for a building from its construction period and the direction it faces. Returns all nine palaces with the period star, the mountain star that governs health and relationships and the water star that governs wealth, plus the named formation and a composed reading for every palace, and the classical verdict on how the two prosperous stars landed. Facing is accepted as one of the 24 mountains or as a compass bearing. Built for property analysis tools, floor plan overlays and consultation software.
+   */
+  generateFlyingStarChart(options) {
+    return (options?.client ?? this.client).post({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/feng-shui/flying-stars/natal",
+      ...options,
+      headers: {
+        "Content-Type": "application/json",
+        ...options?.headers
+      }
+    });
+  }
+  /**
+   * Annual flying stars - Yearly feng shui star chart API
+   *
+   * Return the annual flying star plate for a solar year: which of the nine stars occupies each of the nine palaces, what it means there, and which element strengthens or drains it. The annual plate is universal and does not depend on any building, so it is the layer every yearly feng shui guide is built on. The changeover is Li Chun in early February rather than Lunar New Year, and the exact date is returned so a caller can apply the plate on the right day.
+   */
+  getAnnualFlyingStars(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/feng-shui/flying-stars/annual/{year}",
+      ...options
+    });
+  }
+  /**
+   * Monthly flying stars - Month by month feng shui overlay API
+   *
+   * Return the monthly flying star plate, the faster overlay that sits on top of the annual one. Months here are SOLAR months: month 1 begins at Li Chun in early February and each month begins at the next of the twelve major solar terms, so they never line up with calendar months. Omit both parameters to get the month in progress. Built for monthly guidance features and for timing work around an affliction that only lands for part of the year.
+   */
+  getMonthlyFlyingStars(options) {
+    return (options?.client ?? this.client).get({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/feng-shui/flying-stars/monthly",
+      ...options
+    });
+  }
+  /**
+   * List the nine flying stars - Xuan Kong star reference API
+   *
+   * The reference catalogue of the nine flying stars: name, Chinese characters, five phase, home palace and trigram, the period each rules, what each means, and which element strengthens or drains it. The remedy element is what the star itself produces, because a harmful star is drained by giving it somewhere to go rather than fought with the phase that controls it. A pure reference endpoint that needs no chart.
+   */
+  listFlyingStars(options) {
+    return (options?.client ?? this.client).get({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/feng-shui/flying-stars/stars",
+      ...options
+    });
+  }
+  /**
+   * Annual afflictions - Tai Sui, San Sha and Five Yellow API
+   *
+   * Return the four annual feng shui afflictions for a solar year with their exact positions: Tai Sui on the mountain of the year branch, Sui Po on the mountain opposite, the Three Killings across the cardinal span opposite the elemental frame of the year, and the Five Yellow wherever it lands on the annual star plate. Positions come with degree ranges rather than only sector names, because Tai Sui occupies 15 degrees and the neighbouring mountains of the same sector are unaffected. All four move at Li Chun in early February, not at Lunar New Year, and the changeover date is returned. Built for renovation planning, date selection and yearly guidance features.
+   */
+  getAnnualAfflictions(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/feng-shui/afflictions/{year}",
+      ...options
+    });
+  }
+  /**
+   * List Bagua sectors - Feng shui bagua map API
+   *
+   * The nine palaces of the compass Bagua map: the eight trigram sectors plus the centre, each with the life area it governs, its five phase, its colours, and both its Later Heaven and Earlier Heaven trigrams. This is the compass map aligned to true directions, so career is always North and wealth is always Southeast whichever way the entrance faces. Trigram details are served from the same source as the I-Ching trigram endpoints, so the two agree field for field. Built for floor plan overlays, room-by-room guides and any interface that maps a space onto life areas.
+   */
+  listBaguaSectors(options) {
+    return (options?.client ?? this.client).get({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/feng-shui/bagua",
+      ...options
+    });
+  }
+  /**
+   * Look up a Bagua sector - Life area reference API
+   *
+   * Look up one palace of the compass Bagua map by its life area id, such as wealth, career or love. Returns the compass sector it occupies, its five phase and colours, both trigram arrangements and what the sector governs. The health palace is the centre and carries no direction and no trigram, because the centre of the Lo Shu is not a trigram.
+   */
+  getBaguaSector(options) {
+    return (options.client ?? this.client).get({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/feng-shui/bagua/{id}",
+      ...options
+    });
+  }
+  /**
+   * List the nine periods - San Yuan period table API
+   *
+   * The nine twenty year periods of the 180 year San Yuan cycle from 1864 to 2043, each with its ruling star, five phase, palace and the exact Li Chun date it opened, plus which period is in force on a given date. A building takes the period it was completed in and keeps that period plate for life, so this is the table that decides which natal chart a property gets. Period 9 opened on 4 February 2024, which means a building finished in January 2024 is still a Period 8 building.
+   */
+  listNinePeriods(options) {
+    return (options?.client ?? this.client).get({
+      security: [{ name: "X-API-Key", type: "apiKey" }],
+      url: "/feng-shui/periods",
+      ...options
+    });
+  }
+};
 var Numerology = class extends HeyApiClient {
   /**
    * Calculate Life Path number - Most important numerology calculation
@@ -2876,7 +3250,7 @@ var Tarot = class extends HeyApiClient {
   /**
    * List all 78 tarot cards
    *
-   * Retrieve the complete Rider-Waite-Smith tarot deck of 78 cards: 22 Major Arcana (numbered 0-21, representing life lessons, spiritual themes, and karmic influences like The Fool, Death, The Tower) plus 56 Minor Arcana (4 suits × 14 cards each for daily situations and practical matters). Filter by arcana type (major for spiritual guidance, minor for everyday concerns), suit (cups for emotions and relationships, wands for creativity and passion, swords for intellect and conflict, pentacles for material wealth and finances), or card number (Ace=1 for new beginnings, 2-10 for progression, Page=11 for messages, Knight=12 for action, Queen=13 for mastery, King=14 for authority). Returns lightweight basic card data - use GET /cards/:id for full upright and reversed interpretations with keywords. Perfect for building tarot reference libraries, card databases, learning applications, or browsing the complete traditional deck used by professional tarot readers worldwide.
+   * Retrieve the complete Rider-Waite-Smith tarot deck of 78 cards: 22 Major Arcana (numbered 0-21, representing life lessons, spiritual themes, and karmic influences like The Fool, Death, The Tower) plus 56 Minor Arcana (4 suits × 14 cards each for daily situations and practical matters). Filter by arcana type (major for spiritual guidance, minor for everyday concerns), suit (cups for emotions and relationships, wands for creativity and passion, swords for intellect and conflict, pentacles for material wealth and finances), or card number (Ace=1 for new beginnings, 2-10 for progression, Page=11 for messages, Knight=12 for action, Queen=13 for mastery, King=14 for authority). Returns lightweight basic card data - use GET /cards/{id} for full upright and reversed interpretations with keywords. Perfect for building tarot reference libraries, card databases, learning applications, or browsing the complete traditional deck used by professional tarot readers worldwide.
    */
   listCards(options) {
     return (options?.client ?? this.client).get({
@@ -3246,7 +3620,7 @@ var Crystals = class extends HeyApiClient {
   /**
    * Crystals by Zodiac Sign
    *
-   * Get healing crystals and gemstones associated with a specific zodiac sign. Returns summary data for each crystal. Use the /crystals/:id detail endpoint for full healing properties. Supports all 12 zodiac signs from Aries through Pisces. Perfect for personalized crystal recommendations based on astrological birth chart data.
+   * Get healing crystals and gemstones associated with a specific zodiac sign. Returns summary data for each crystal. Use the /crystals/{id} detail endpoint for full healing properties. Supports all 12 zodiac signs from Aries through Pisces. Perfect for personalized crystal recommendations based on astrological birth chart data.
    */
   getCrystalsByZodiac(options) {
     return (options.client ?? this.client).get({
@@ -3258,7 +3632,7 @@ var Crystals = class extends HeyApiClient {
   /**
    * Crystals by Chakra
    *
-   * Get healing crystals and gemstones that resonate with a specific chakra energy center. Returns summary data for each crystal. Use the /crystals/:id detail endpoint for full healing properties. Supports all 7 primary chakras: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, and Crown. Essential for crystal grid building, chakra balancing, and energy healing applications.
+   * Get healing crystals and gemstones that resonate with a specific chakra energy center. Returns summary data for each crystal. Use the /crystals/{id} detail endpoint for full healing properties. Supports all 7 primary chakras: Root, Sacral, Solar Plexus, Heart, Throat, Third Eye, and Crown. Essential for crystal grid building, chakra balancing, and energy healing applications.
    */
   getCrystalsByChakra(options) {
     return (options.client ?? this.client).get({
@@ -3270,7 +3644,7 @@ var Crystals = class extends HeyApiClient {
   /**
    * Crystals by Element
    *
-   * Get healing crystals and gemstones associated with a specific natural element. Returns summary data for each crystal. Use the /crystals/:id detail endpoint for full healing properties. Supports five elements: Earth, Water, Fire, Air, and Storm. Essential for elemental crystal selection, nature-based healing, and element-themed crystal grid applications.
+   * Get healing crystals and gemstones associated with a specific natural element. Returns summary data for each crystal. Use the /crystals/{id} detail endpoint for full healing properties. Supports five elements: Earth, Water, Fire, Air, and Storm. Essential for elemental crystal selection, nature-based healing, and element-themed crystal grid applications.
    */
   getCrystalsByElement(options) {
     return (options.client ?? this.client).get({
@@ -3282,7 +3656,7 @@ var Crystals = class extends HeyApiClient {
   /**
    * Birthstone Crystals by Month
    *
-   * Get the traditional birthstone crystals for a given birth month. Returns summary data for each crystal. Use the /crystals/:id detail endpoint for full healing properties. Based on GIA-authoritative birthstone assignments. Perfect for birthday gift recommendations, personalized crystal suggestions, and birthstone jewelry applications.
+   * Get the traditional birthstone crystals for a given birth month. Returns summary data for each crystal. Use the /crystals/{id} detail endpoint for full healing properties. Based on GIA-authoritative birthstone assignments. Perfect for birthday gift recommendations, personalized crystal suggestions, and birthstone jewelry applications.
    */
   getBirthstones(options) {
     return (options.client ?? this.client).get({
@@ -3294,7 +3668,7 @@ var Crystals = class extends HeyApiClient {
   /**
    * Search Crystals
    *
-   * Search for healing crystals by keyword or name. Matches against crystal names, healing keywords, descriptions, and spiritual/emotional/physical meaning fields. Returns summary data for each crystal. Use the /crystals/:id detail endpoint for full healing properties. Useful for building crystal search bars, keyword-based recommendation features, and healing property lookups.
+   * Search for healing crystals by keyword or name. Matches against crystal names, healing keywords, descriptions, and spiritual/emotional/physical meaning fields. Returns summary data for each crystal. Use the /crystals/{id} detail endpoint for full healing properties. Useful for building crystal search bars, keyword-based recommendation features, and healing property lookups.
    */
   searchCrystals(options) {
     return (options.client ?? this.client).get({
@@ -3318,7 +3692,7 @@ var Crystals = class extends HeyApiClient {
   /**
    * Daily Crystal
    *
-   * Get the crystal of the day as a discovery teaser. Returns a deterministic crystal based on the current date (or a provided seed date), ensuring all users see the same crystal for any given day. Use the /crystals/:id detail endpoint for complete spiritual, emotional, and physical healing properties. Perfect for daily guidance features, push notifications, wellness app widgets, and crystal journal integrations.
+   * Get the crystal of the day as a discovery teaser. Returns a deterministic crystal based on the current date (or a provided seed date), ensuring all users see the same crystal for any given day. Use the /crystals/{id} detail endpoint for complete spiritual, emotional, and physical healing properties. Perfect for daily guidance features, push notifications, wellness app widgets, and crystal journal integrations.
    */
   getDailyCrystal(options) {
     return (options?.client ?? this.client).post({
@@ -3334,7 +3708,7 @@ var Crystals = class extends HeyApiClient {
   /**
    * Random Crystal
    *
-   * Get a randomly selected healing crystal as a discovery teaser. Returns a different crystal on each request (non-deterministic). Use the /crystals/:id detail endpoint for complete spiritual, emotional, and physical healing properties. Perfect for crystal discovery features, surprise crystal picks, crystal roulette games, and exploration widgets. For a deterministic daily crystal that is the same for all users on a given date, use the /daily endpoint instead.
+   * Get a randomly selected healing crystal as a discovery teaser. Returns a different crystal on each request (non-deterministic). Use the /crystals/{id} detail endpoint for complete spiritual, emotional, and physical healing properties. Perfect for crystal discovery features, surprise crystal picks, crystal roulette games, and exploration widgets. For a deterministic daily crystal that is the same for all users on a given date, use the /daily endpoint instead.
    */
   getRandomCrystal(options) {
     return (options?.client ?? this.client).get({
@@ -3590,6 +3964,14 @@ var Roxy = class _Roxy extends HeyApiClient {
   get humanDesign() {
     return this._humanDesign ??= new HumanDesign({ client: this.client });
   }
+  _chineseAstrology;
+  get chineseAstrology() {
+    return this._chineseAstrology ??= new ChineseAstrology({ client: this.client });
+  }
+  _fengShui;
+  get fengShui() {
+    return this._fengShui ??= new FengShui({ client: this.client });
+  }
   _numerology;
   get numerology() {
     return this._numerology ??= new Numerology({ client: this.client });
@@ -3629,7 +4011,7 @@ var Roxy = class _Roxy extends HeyApiClient {
 };
 
 // src/version.ts
-var VERSION = "1.2.69";
+var VERSION = "1.2.70";
 
 // src/factory.ts
 function createRoxy(auth) {
@@ -3649,8 +4031,10 @@ function createRoxy(auth) {
   AngelNumbers,
   Astrology,
   Biorhythm,
+  ChineseAstrology,
   Crystals,
   Dreams,
+  FengShui,
   Forecast,
   HumanDesign,
   Iching,