release: v1.2.70

Author: github-actions[bot]

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... |

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... |

docs/llms-full.txt

@@ -10,7 +10,7 @@ const roxy = createRoxy(process.env.ROXY_API_KEY!);
 ```
 
 <!-- BEGIN:LANGS -->
-**Multi-language responses.** Interpretations are available in 8 languages: `en`, `tr`, `de`, `es`, `hi`, `pt`, `fr`, `ru`. Pass `query: { lang }` on any supported endpoint. Supported: astrology, vedicAstrology, forecast, humanDesign, numerology, tarot, biorhythm, iching, crystals, angelNumbers, languages. English-only: dreams, location, usage. Languages without translations yet fall back to English.
+**Multi-language responses.** Interpretations are available in 10 languages: `en`, `tr`, `de`, `es`, `hi`, `pt`, `fr`, `ru`, `zh-Hans`, `zh-Hant`. Pass `query: { lang }` on any supported endpoint. Supported: astrology, vedicAstrology, forecast, humanDesign, chineseAstrology, fengShui, numerology, tarot, biorhythm, iching, crystals, angelNumbers, languages. English-only: dreams, location, usage. Languages without translations yet fall back to English.
 <!-- END:LANGS -->
 
 ```typescript
@@ -1325,6 +1325,209 @@ const { data } = await roxy.humanDesign.calculateVariables({
 
 ---
 
+## Chinese Astrology — `roxy.chineseAstrology`
+
+Calculate BaZi Four Pillars charts, Chinese zodiac signs, and the Chinese lunisolar calendar from any birth moment: y...
+
+```typescript
+// Generate BaZi chart - Four Pillars of Destiny calculator API
+const { data } = await roxy.chineseAstrology.generateBaziChart({
+  body: {
+    date: '1990-06-15',
+    time: '14:30:00',
+    timezone: 'America/New_York',
+    latitude: 0,
+    longitude: 116.4,
+    dayBoundary: 'split-zi',
+    yearBoundary: 'li-chun',
+    hourClock: 'clock',
+  },
+});
+
+// Calculate luck pillars - BaZi Da Yun ten-year cycle API
+const { data } = await roxy.chineseAstrology.calculateLuckPillars({
+  body: {
+    date: '1990-06-15',
+    time: '14:30:00',
+    timezone: 'America/New_York',
+    latitude: 0,
+    longitude: 116.4,
+    dayBoundary: 'split-zi',
+    yearBoundary: 'li-chun',
+    hourClock: 'clock',
+    gender: 'male',
+    count: 8,
+    annualFromYear: 2026,
+    annualYears: 10,
+  },
+});
+
+// Calculate Day Master strength - BaZi favorable element API
+const { data } = await roxy.chineseAstrology.calculateDayMasterStrength({
+  body: {
+    date: '1990-06-15',
+    time: '14:30:00',
+    timezone: 'America/New_York',
+    latitude: 0,
+    longitude: 116.4,
+    dayBoundary: 'split-zi',
+    yearBoundary: 'li-chun',
+    hourClock: 'clock',
+  },
+});
+
+// Calculate BaZi compatibility - Four Pillars matchmaking API
+const { data } = await roxy.chineseAstrology.calculateBaziCompatibility({
+  body: {
+    personA: {
+      date: '1990-06-15',
+      time: '14:30:00',
+      timezone: 'America/New_York',
+      latitude: 0,
+      longitude: 116.4,
+      dayBoundary: 'split-zi',
+      yearBoundary: 'li-chun',
+      hourClock: 'clock',
+    },
+    personB: {
+      date: '1990-06-15',
+      time: '14:30:00',
+      timezone: 'America/New_York',
+      latitude: 0,
+      longitude: 116.4,
+      dayBoundary: 'split-zi',
+      yearBoundary: 'li-chun',
+      hourClock: 'clock',
+    },
+  },
+});
+
+// Calculate BaZi annual forecast - Liu Nian yearly pillar API
+const { data } = await roxy.chineseAstrology.calculateAnnualForecast({
+  body: {
+    date: '1990-06-15',
+    time: '14:30:00',
+    timezone: 'America/New_York',
+    latitude: 0,
+    longitude: 116.4,
+    dayBoundary: 'split-zi',
+    yearBoundary: 'li-chun',
+    hourClock: 'clock',
+    year: 2026,
+  },
+});
+
+// List the 12 Chinese zodiac animals - Sheng Xiao sign catalogue
+const { data } = await roxy.chineseAstrology.listZodiacAnimals({ query: { limit: 12, offset: 0 } });
+
+// Get one Chinese zodiac animal - Full sign profile with compatibility partners
+const { data } = await roxy.chineseAstrology.getZodiacAnimal({ path: { id: 'rat' } });
+
+// Find the Chinese zodiac animal for a birth date - Sheng Xiao calculator
+const { data } = await roxy.chineseAstrology.calculateZodiacAnimal({
+  body: { date: '1990-06-15', yearBoundary: 'lunar-new-year' },
+});
+
+// Chinese zodiac compatibility - Trine, six harmony, clash and harm analysis
+const { data } = await roxy.chineseAstrology.getZodiacCompatibility({ path: { sign1: 'rat', sign2: 'dragon' } });
+
+// Daily Chinese zodiac reading - Day pillar forecast by animal sign
+const { data } = await roxy.chineseAstrology.getDailyZodiacReading({
+  path: { id: 'rat' },
+  query: { date: '2026-04-03', timezone: 'America/New_York' },
+});
+
+// List the 24 solar terms - Jie Qi calendar API with exact instants
+const { data } = await roxy.chineseAstrology.listSolarTerms({ path: { year: 2026 } });
+
+// Convert lunar and Gregorian dates - Chinese lunisolar calendar API
+const { data } = await roxy.chineseAstrology.calculateLunarDate({
+  body: {
+    date: '1990-06-15',
+    lunarYear: 1990,
+    lunarMonth: 5,
+    lunarDay: 23,
+    isLeapMonth: false,
+  },
+});
+
+// Get the almanac for a day - Tong Shu API with day officers and mansions
+const { data } = await roxy.chineseAstrology.getAlmanacDay({ path: { date: '1990-06-15' } });
+
+// Get a month of almanac days - Chinese calendar month view API
+const { data } = await roxy.chineseAstrology.getMonthlyAlmanac({ query: { year: 1990, month: 6 } });
+
+// Find auspicious days - Chinese date selection API for weddings and openings
+const { data } = await roxy.chineseAstrology.lookupAuspiciousDays({
+  body: {
+    activity: 'wedding',
+    startDate: '2026-03-01',
+    endDate: '2026-04-30',
+    avoidAnimal: 'rat',
+  },
+});
+
+// List the five elements - Wu Xing API with generating and controlling cycles
+const { data } = await roxy.chineseAstrology.listFiveElements({ query: { limit: 5, offset: 0 } });
+```
+
+---
+
+## Feng Shui — `roxy.fengShui`
+
+Compute classical feng shui from one API: Xuan Kong flying star natal charts for any of the nine periods and 24 mount...
+
+```typescript
+// Calculate Kua number - Feng shui personal direction calculator API
+const { data } = await roxy.fengShui.calculateKuaNumber({
+  body: {
+    date: '1985-07-15',
+    gender: 'male',
+    yearBoundary: 'li-chun',
+  },
+});
+
+// Look up a Kua number - Eight Mansions reference API
+const { data } = await roxy.fengShui.getKuaNumber({ path: { number: 8 } });
+
+// Generate Eight Mansions map - Ba Zhai lucky direction API
+const { data } = await roxy.fengShui.generateEightMansions({
+  body: {
+    kua: 6,
+    date: '1985-07-15',
+    gender: 'male',
+    yearBoundary: 'li-chun',
+    facing: 'Southeast',
+  },
+});
+
+// Generate flying star natal chart - Xuan Kong Fei Xing API
+const { data } = await roxy.fengShui.generateFlyingStarChart({ body: { period: 9, facing: 'wu', facingDegrees: 180 } });
+
+// Annual flying stars - Yearly feng shui star chart API
+const { data } = await roxy.fengShui.getAnnualFlyingStars({ path: { year: 2026 } });
+
+// Monthly flying stars - Month by month feng shui overlay API
+const { data } = await roxy.fengShui.getMonthlyFlyingStars({ query: { year: 2026, month: 1 } });
+
+// List the nine flying stars - Xuan Kong star reference API
+const { data } = await roxy.fengShui.listFlyingStars({ query: { limit: 20, offset: 0 } });
+
+// Annual afflictions - Tai Sui, San Sha and Five Yellow API
+const { data } = await roxy.fengShui.getAnnualAfflictions({ path: { year: 2026 } });
+
+// List Bagua sectors - Feng shui bagua map API
+const { data } = await roxy.fengShui.listBaguaSectors({ query: { limit: 20, offset: 0 } });
+
+// Look up a Bagua sector - Life area reference API
+const { data } = await roxy.fengShui.getBaguaSector({ path: { id: 'wealth' } });
+
+// List the nine periods - San Yuan period table API
+const { data } = await roxy.fengShui.listNinePeriods({ query: { date: '2026-08-23' } });
+```
+
+---
+
 ## Numerology — `roxy.numerology`
 
 Numerology API to calculate life path, expression, soul urge, personality, and maturity numbers, with Pinnacle and Ch...

package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@roxyapi/sdk",
-	"version": "1.2.69",
+	"version": "1.2.70",
 	"description": "TypeScript SDK for Roxy — the multi-domain spiritual intelligence API",
 	"type": "module",
 	"exports": {