lifeastroapi 0.7.0 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -32,10 +32,10 @@ type HouseSystem = "whole-sign" | "equal" | "placidus" | "koch" | "porphyry" | "
32
32
  * numerology, dasha, varshaphal, ashtakavarga, Lal Kitab, horoscope, reports,
33
33
  * narrative, remedies).
34
34
  *
35
- * - Complete: `en`, `hi`, `mr`, `te`, `ta`, `kn`, `ml`, `gu`. Names, terms and
36
- * prose all come back in the language.
37
- * - Partial: `bn`, `pa`. Names and terms come back in the language; longer
38
- * prose is still English.
35
+ * - Complete: `en`, `hi`, `mr`, `te`, `ta`, `kn`, `ml`, `gu`, `bn`. Names, terms
36
+ * and prose all come back in the language.
37
+ * - Partial: `pa`. Names and terms come back in the language; longer prose is
38
+ * still English.
39
39
  *
40
40
  * Ids, dates, numbers and explicit `*_en` / `*_hi` fields stay as they are in
41
41
  * every language. Western, Tarot, geo and meta methods answer in English
@@ -227,24 +227,28 @@ declare class Calendar {
227
227
  adhikMaas<T = unknown>(input: {
228
228
  year: number;
229
229
  tz?: string;
230
+ ayanamsa?: string;
230
231
  lang?: Locale;
231
232
  }, opts?: RequestOptions): Promise<T>;
232
233
  /** Get the Hindu calendar details for a Gregorian month — maps each day to its Hindu month (Chaitra/Vaishakha/…), paksha (Shukla/Krishna), tithi, and Vikram Samvat year. */
233
234
  month<T = unknown>(input: {
234
235
  date: string;
235
236
  tz: string;
237
+ ayanamsa?: string;
236
238
  lang?: Locale;
237
239
  }, opts?: RequestOptions): Promise<T>;
238
240
  /** Get the current Hindu Ritu (season) for a date — one of 6 seasons: Vasanta (spring), Grishma (summer), Varsha (monsoon), Sharad (autumn), Hemanta (pre-winter), Shishira (winter). */
239
241
  ritu<T = unknown>(input: {
240
242
  date: string;
241
243
  tz: string;
244
+ ayanamsa?: string;
242
245
  lang?: Locale;
243
246
  }, opts?: RequestOptions): Promise<T>;
244
247
  /** Get the Samvatsara (Jupiter year) name for a given year — the 60-year Jupiter cycle used in Hindu astrology (Prabhava, Vibhava, Shukla, … Akshaya). */
245
248
  samvatsara<T = unknown>(input: {
246
249
  date: string;
247
250
  tz: string;
251
+ ayanamsa?: string;
248
252
  lang?: Locale;
249
253
  }, opts?: RequestOptions): Promise<T>;
250
254
  /** Equinoxes and solstices of a year — exact moment (UTC + local), the ayana that begins (tropical Dakshinayana at the June solstice, tropical Uttarayana at the December solstice; the panchang's Uttarayana is Makara Sankranti), and with lat/lon the sunrise, sunset and day length at that place. */
@@ -391,8 +395,9 @@ declare class Dasha {
391
395
  ad: string;
392
396
  lang?: Locale;
393
397
  }, opts?: RequestOptions): Promise<T>;
394
- /** Currently running Char Dasha (Jaimini) period stack — active mahadasha and antardasha signs with date windows. */
398
+ /** Currently running Char Dasha (Jaimini) period stack — active mahadasha and antardasha signs with date windows (optionally at a custom moment `at`, UTC). */
395
399
  charCurrent<T = unknown>(input: BirthInput & VedicBirthSettings & {
400
+ at?: string;
396
401
  lang?: Locale;
397
402
  }, opts?: RequestOptions): Promise<T>;
398
403
  /** Antardashas inside one Char Dasha mahadasha sign (md = sign name, e.g. 'leo'). */
@@ -578,8 +583,9 @@ declare class Lalkitab {
578
583
  dasha<T = unknown>(input: BirthInput & VedicBirthSettings & {
579
584
  lang?: Locale;
580
585
  }, opts?: RequestOptions): Promise<T>;
581
- /** Currently active Lal Kitab dasha planet and period window. */
586
+ /** Currently active Lal Kitab dasha planet and period window (optionally at a custom moment `at`, UTC). */
582
587
  dashaCurrent<T = unknown>(input: BirthInput & VedicBirthSettings & {
588
+ at?: string;
583
589
  lang?: Locale;
584
590
  }, opts?: RequestOptions): Promise<T>;
585
591
  }
@@ -682,8 +688,12 @@ declare class Milan {
682
688
  declare class Muhurta {
683
689
  private readonly _c;
684
690
  constructor(_c: ClientCore);
685
- /** Best-scoring general muhurta window in a date range. Each `factors[]` item has a stable English `id` (e.g. `Tithi`, `RahuKaal`); `name` and `value` follow `lang`. */
691
+ /** Best-scoring muhurta windows in a date range. `purpose` is `general` (default), `vivah`, `graha_pravesh` or `naamkaran`; `topN` (1-20, default 5) sets how many windows come back; `birthDate` (YYYY-MM-DD) weights the windows by the person's tara bala and chandra bala. Each `factors[]` item has a stable English `id` (e.g. `Tithi`, `RahuKaal`); `name` and `value` follow `lang`. */
686
692
  bestTime<T = unknown>(input: MuhurtaInput & {
693
+ purpose?: string;
694
+ topN?: number;
695
+ birthDate?: string;
696
+ ayanamsa?: string;
687
697
  lang?: Locale;
688
698
  }, opts?: RequestOptions): Promise<T>;
689
699
  /** Compute Chandra Bala — the Moon's strength relative to a person's natal Moon sign on a given date. */
@@ -1105,6 +1115,7 @@ declare class PlanetMoments {
1105
1115
  time?: string;
1106
1116
  tz: string;
1107
1117
  maxDays?: number;
1118
+ ayanamsa?: string;
1108
1119
  lang?: Locale;
1109
1120
  }, opts?: RequestOptions): Promise<T>;
1110
1121
  /** A planet's sign ingresses (sankranti) in a date range. */
@@ -1114,6 +1125,7 @@ declare class PlanetMoments {
1114
1125
  time?: string;
1115
1126
  tz: string;
1116
1127
  maxDays?: number;
1128
+ ayanamsa?: string;
1117
1129
  lang?: Locale;
1118
1130
  }, opts?: RequestOptions): Promise<T>;
1119
1131
  /** A planet's retrograde windows (station retro -> station direct) in a date range. */
@@ -1249,8 +1261,9 @@ declare class Reports {
1249
1261
  month: string;
1250
1262
  lang?: string;
1251
1263
  }, opts?: RequestOptions): Promise<T>;
1252
- /** Generate a detailed weekly horoscope report for a Moon sign — structured report covering the week's planetary movement, day-by-day highlights, and focus areas. */
1264
+ /** Generate a detailed weekly horoscope report for a Moon sign — structured report covering the week's planetary movement, day-by-day highlights, and focus areas. `week` is an ISO week such as `2026-W47` (default: the current week). */
1253
1265
  horoscopeWeekly<T = unknown>(input: RashiInput & {
1266
+ week?: string;
1254
1267
  lang?: string;
1255
1268
  }, opts?: RequestOptions): Promise<T>;
1256
1269
  /** Generate the Brihad (comprehensive) Kundli report — the most detailed birth chart report covering chart analysis, all divisional charts (D1–D60), planetary strengths (Shadbala), ashtakavarga, all dashas, yogas, doshas, remedies, and lifetime predictions. */
@@ -1440,25 +1453,69 @@ declare class WesternComposite {
1440
1453
  private readonly _c;
1441
1454
  constructor(_c: ClientCore);
1442
1455
  /** Get aspects in the composite (midpoint) chart for two people — shows how the relationship's combined energy is configured. */
1443
- aspects<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1456
+ aspects<T = unknown>(input: TwoPersonInput & {
1457
+ orbConjunction?: number;
1458
+ orbOpposition?: number;
1459
+ orbTrine?: number;
1460
+ orbSquare?: number;
1461
+ orbSextile?: number;
1462
+ compositeMethod?: string;
1463
+ houseSystem?: string;
1464
+ }, opts?: RequestOptions): Promise<T>;
1444
1465
  /** Composite (midpoint) relationship chart. */
1445
- chart<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1466
+ chart<T = unknown>(input: TwoPersonInput & {
1467
+ orbConjunction?: number;
1468
+ orbOpposition?: number;
1469
+ orbTrine?: number;
1470
+ orbSquare?: number;
1471
+ orbSextile?: number;
1472
+ rulership?: string;
1473
+ compositeMethod?: string;
1474
+ houseSystem?: string;
1475
+ }, opts?: RequestOptions): Promise<T>;
1446
1476
  /** Compute the house cusps of the Composite chart for two people — the midpoint chart combining both natal charts to represent the relationship itself. */
1447
- houses<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1477
+ houses<T = unknown>(input: TwoPersonInput & {
1478
+ rulership?: string;
1479
+ compositeMethod?: string;
1480
+ houseSystem?: string;
1481
+ }, opts?: RequestOptions): Promise<T>;
1448
1482
  /** Compute the planet placements in the Composite chart for two people — midpoint positions for all planets in the relationship chart. */
1449
- planets<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1483
+ planets<T = unknown>(input: TwoPersonInput & {
1484
+ compositeMethod?: string;
1485
+ houseSystem?: string;
1486
+ }, opts?: RequestOptions): Promise<T>;
1450
1487
  }
1451
1488
  declare class WesternDavison {
1452
1489
  private readonly _c;
1453
1490
  constructor(_c: ClientCore);
1454
1491
  /** Get aspects in the Davison relationship chart. */
1455
- aspects<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1492
+ aspects<T = unknown>(input: TwoPersonInput & {
1493
+ orbConjunction?: number;
1494
+ orbOpposition?: number;
1495
+ orbTrine?: number;
1496
+ orbSquare?: number;
1497
+ orbSextile?: number;
1498
+ houseSystem?: string;
1499
+ }, opts?: RequestOptions): Promise<T>;
1456
1500
  /** Compute the Davison relationship chart — an alternative to the composite chart that uses the midpoint of the two birth times rather than midpoint longitudes. */
1457
- chart<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1501
+ chart<T = unknown>(input: TwoPersonInput & {
1502
+ orbConjunction?: number;
1503
+ orbOpposition?: number;
1504
+ orbTrine?: number;
1505
+ orbSquare?: number;
1506
+ orbSextile?: number;
1507
+ rulership?: string;
1508
+ houseSystem?: string;
1509
+ }, opts?: RequestOptions): Promise<T>;
1458
1510
  /** Compute the house cusps of the Davison Relationship chart — the chart for the midpoint in time and space between two people's births (an actual chart for a real moment, unlike the composite). */
1459
- houses<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1511
+ houses<T = unknown>(input: TwoPersonInput & {
1512
+ rulership?: string;
1513
+ houseSystem?: string;
1514
+ }, opts?: RequestOptions): Promise<T>;
1460
1515
  /** Compute the planet placements in the Davison Relationship chart — all planet positions in the Davison chart's tropical zodiac. */
1461
- planets<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1516
+ planets<T = unknown>(input: TwoPersonInput & {
1517
+ houseSystem?: string;
1518
+ }, opts?: RequestOptions): Promise<T>;
1462
1519
  }
1463
1520
  declare class WesternDignities {
1464
1521
  private readonly _c;
@@ -1625,11 +1682,19 @@ declare class WesternNatal {
1625
1682
  /** Antiscia (solstice points) and contra-antiscia. */
1626
1683
  antiscia<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1627
1684
  /** Compute the Western (tropical) natal Ascendant — rising sign, degree, and Midheaven in the tropical zodiac. */
1628
- ascendant<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1685
+ ascendant<T = unknown>(input: WesternNatalInput & {
1686
+ rulership?: string;
1687
+ }, opts?: RequestOptions): Promise<T>;
1629
1688
  /** Detect classical multi-planet aspect patterns in a natal chart — Grand Trine, T-Square, Grand Cross, Yod (Finger of God), Kite, Mystic Rectangle, Stellium, Grand Sextile. */
1630
1689
  aspectPatterns<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1631
1690
  /** All natal aspects with orbs and partile flags. */
1632
- aspects<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1691
+ aspects<T = unknown>(input: WesternNatalInput & {
1692
+ orbConjunction?: number;
1693
+ orbOpposition?: number;
1694
+ orbTrine?: number;
1695
+ orbSquare?: number;
1696
+ orbSextile?: number;
1697
+ }, opts?: RequestOptions): Promise<T>;
1633
1698
  /** A single asteroid by MPC number. */
1634
1699
  asteroid<T = unknown>(input: WesternNatalInput & {
1635
1700
  number: number | string;
@@ -1639,7 +1704,14 @@ declare class WesternNatal {
1639
1704
  /** Get natal positions for the centaur bodies: Pholus, Nessus, Asbolus, and Chariklo. */
1640
1705
  centaurs<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1641
1706
  /** Western (tropical) natal chart: planets, ascendant, MC, houses and aspects. */
1642
- chart<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1707
+ chart<T = unknown>(input: WesternNatalInput & {
1708
+ orbConjunction?: number;
1709
+ orbOpposition?: number;
1710
+ orbTrine?: number;
1711
+ orbSquare?: number;
1712
+ orbSextile?: number;
1713
+ rulership?: string;
1714
+ }, opts?: RequestOptions): Promise<T>;
1643
1715
  /** Classify the natal chart into one of the seven Jones planetary distribution patterns: Splash, Bundle, Locomotive, Bowl, Bucket, See-Saw, or Splay. */
1644
1716
  chartShape<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1645
1717
  /** Planetary declinations, parallels and out-of-bounds. */
@@ -1661,7 +1733,9 @@ declare class WesternNatal {
1661
1733
  harmonics?: string;
1662
1734
  }, opts?: RequestOptions): Promise<T>;
1663
1735
  /** Western tropical house cusps + Ascendant and MC. */
1664
- houses<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1736
+ houses<T = unknown>(input: WesternNatalInput & {
1737
+ rulership?: string;
1738
+ }, opts?: RequestOptions): Promise<T>;
1665
1739
  /** Get all Lilith positions: Mean Black Moon Lilith, True Black Moon Lilith, Osculating (Interpolated) Lilith, and asteroid 1181 Lilith. */
1666
1740
  lilithSet<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1667
1741
  /** A single Arabic Lot (fortune|spirit|eros|...). */
@@ -1671,7 +1745,9 @@ declare class WesternNatal {
1671
1745
  /** All Hellenistic Arabic Parts (Lots). */
1672
1746
  lots<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1673
1747
  /** Compute the Midheaven (Medium Coeli, MC) and its tropical sign for a Western birth chart — the career and public reputation point, along with its aspects to natal planets. */
1674
- mc<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1748
+ mc<T = unknown>(input: WesternNatalInput & {
1749
+ rulership?: string;
1750
+ }, opts?: RequestOptions): Promise<T>;
1675
1751
  /** All planet-pair midpoints and activations. */
1676
1752
  midpoints<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1677
1753
  /** Ebertin 90-degree dial midpoint tree. */
@@ -1743,6 +1819,11 @@ declare class WesternProgressions {
1743
1819
  /** Get secondary progressed planet aspects to natal planets — the slow symbolic evolution of the birth chart over time. */
1744
1820
  aspectsToNatal<T = unknown>(input: WesternNatalInput & {
1745
1821
  ageInYears: number;
1822
+ orbConjunction?: number;
1823
+ orbOpposition?: number;
1824
+ orbTrine?: number;
1825
+ orbSquare?: number;
1826
+ orbSextile?: number;
1746
1827
  }, opts?: RequestOptions): Promise<T>;
1747
1828
  /** Get the progressed Moon phase — shows what stage of the 29-year progressed lunation cycle you are in (new moon, crescent, first quarter, gibbous, full moon, disseminating, last quarter, balsamic). */
1748
1829
  lunation<T = unknown>(input: WesternNatalInput & {
@@ -1759,6 +1840,9 @@ declare class WesternReturns {
1759
1840
  /** Compute the Lunar Return chart — the chart for the exact moment the transiting Moon returns to its natal degree (~every 27.3 days). */
1760
1841
  lunar<T = unknown>(input: WesternNatalInput & {
1761
1842
  from: string;
1843
+ rulership?: string;
1844
+ relocateLat?: number;
1845
+ relocateLon?: number;
1762
1846
  }, opts?: RequestOptions): Promise<T>;
1763
1847
  /** Get the aspects formed between planets in the lunar return chart. */
1764
1848
  lunarAspects<T = unknown>(input: WesternNatalInput & {
@@ -1767,6 +1851,9 @@ declare class WesternReturns {
1767
1851
  /** Solar Return chart for a year. */
1768
1852
  solar<T = unknown>(input: WesternNatalInput & {
1769
1853
  returnYear: number;
1854
+ rulership?: string;
1855
+ relocateLat?: number;
1856
+ relocateLon?: number;
1770
1857
  }, opts?: RequestOptions): Promise<T>;
1771
1858
  /** Get the aspects formed between planets in the solar return chart — shows which planets are strongly configured in the return year. */
1772
1859
  solarAspects<T = unknown>(input: WesternNatalInput & {
@@ -1783,6 +1870,11 @@ declare class WesternSolarArc {
1783
1870
  /** Get solar arc directed planet aspects to natal planets — a predictive technique where all planets advance at the rate of the Sun (~1°/year). */
1784
1871
  aspectsToNatal<T = unknown>(input: WesternNatalInput & {
1785
1872
  ageInYears: number;
1873
+ orbConjunction?: number;
1874
+ orbOpposition?: number;
1875
+ orbTrine?: number;
1876
+ orbSquare?: number;
1877
+ orbSextile?: number;
1786
1878
  }, opts?: RequestOptions): Promise<T>;
1787
1879
  /** Solar Arc directed planetary positions at an age. */
1788
1880
  planets<T = unknown>(input: WesternNatalInput & {
@@ -1793,11 +1885,32 @@ declare class WesternSynastry {
1793
1885
  private readonly _c;
1794
1886
  constructor(_c: ClientCore);
1795
1887
  /** Cross-chart synastry aspects between two charts. */
1796
- aspects<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1888
+ aspects<T = unknown>(input: TwoPersonInput & {
1889
+ orbConjunction?: number;
1890
+ orbOpposition?: number;
1891
+ orbTrine?: number;
1892
+ orbSquare?: number;
1893
+ orbSextile?: number;
1894
+ houseSystem?: string;
1895
+ }, opts?: RequestOptions): Promise<T>;
1797
1896
  /** Get the full N×M synastry aspect grid between two natal charts — every planet in chart A aspecting every planet in chart B. */
1798
- grid<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1897
+ grid<T = unknown>(input: TwoPersonInput & {
1898
+ orbConjunction?: number;
1899
+ orbOpposition?: number;
1900
+ orbTrine?: number;
1901
+ orbSquare?: number;
1902
+ orbSextile?: number;
1903
+ houseSystem?: string;
1904
+ }, opts?: RequestOptions): Promise<T>;
1799
1905
  /** Synastry compatibility score and breakdown. */
1800
- score<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1906
+ score<T = unknown>(input: TwoPersonInput & {
1907
+ orbConjunction?: number;
1908
+ orbOpposition?: number;
1909
+ orbTrine?: number;
1910
+ orbSquare?: number;
1911
+ orbSextile?: number;
1912
+ houseSystem?: string;
1913
+ }, opts?: RequestOptions): Promise<T>;
1801
1914
  }
1802
1915
  declare class WesternTransits {
1803
1916
  private readonly _c;
@@ -1818,7 +1931,13 @@ declare class WesternTransits {
1818
1931
  /** Current tropical planetary positions for transit analysis. */
1819
1932
  positions<T = unknown>(input: WesternMomentInput, opts?: RequestOptions): Promise<T>;
1820
1933
  /** All current transiting aspects to natal planets. */
1821
- toNatal<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1934
+ toNatal<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
1935
+ orbConjunction?: number;
1936
+ orbOpposition?: number;
1937
+ orbTrine?: number;
1938
+ orbSquare?: number;
1939
+ orbSextile?: number;
1940
+ }, opts?: RequestOptions): Promise<T>;
1822
1941
  }
1823
1942
  declare class WesternZodiacalReleasing {
1824
1943
  private readonly _c;
@@ -1912,7 +2031,7 @@ declare class Resources {
1912
2031
  */
1913
2032
 
1914
2033
  /** SDK version, surfaced in the User-Agent header. */
1915
- declare const VERSION = "0.2.0";
2034
+ declare const VERSION = "0.9.0";
1916
2035
  interface LifeAstroOptions {
1917
2036
  /**
1918
2037
  * API key (`dv_live_...`). Falls back to the `LIFEASTRO_API_KEY` environment
package/dist/index.js CHANGED
@@ -406,19 +406,19 @@ var Calendar = class {
406
406
  }
407
407
  /** Find the Adhik Maas (intercalary/leap month) in a given year — the extra lunar month inserted to sync the Hindu lunar calendar with the solar year. */
408
408
  adhikMaas(input, opts) {
409
- return this._c.request("/v1/calendar/adhik-maas", applyExtras(qNone(input), input, [["year", "year"], ["tz", "tz"], ["lang", "lang"], ["lang", "locale"]]), opts);
409
+ return this._c.request("/v1/calendar/adhik-maas", applyExtras(qNone(input), input, [["year", "year"], ["tz", "tz"], ["ayanamsa", "ayanamsa"], ["lang", "lang"], ["lang", "locale"]]), opts);
410
410
  }
411
411
  /** Get the Hindu calendar details for a Gregorian month — maps each day to its Hindu month (Chaitra/Vaishakha/…), paksha (Shukla/Krishna), tithi, and Vikram Samvat year. */
412
412
  month(input, opts) {
413
- return this._c.request("/v1/calendar/month", applyExtras(qNone(input), input, [["date", "date"], ["tz", "tz"], ["lang", "lang"], ["lang", "locale"]]), opts);
413
+ return this._c.request("/v1/calendar/month", applyExtras(qNone(input), input, [["date", "date"], ["tz", "tz"], ["ayanamsa", "ayanamsa"], ["lang", "lang"], ["lang", "locale"]]), opts);
414
414
  }
415
415
  /** Get the current Hindu Ritu (season) for a date — one of 6 seasons: Vasanta (spring), Grishma (summer), Varsha (monsoon), Sharad (autumn), Hemanta (pre-winter), Shishira (winter). */
416
416
  ritu(input, opts) {
417
- return this._c.request("/v1/calendar/ritu", applyExtras(qNone(input), input, [["date", "date"], ["tz", "tz"], ["lang", "lang"], ["lang", "locale"]]), opts);
417
+ return this._c.request("/v1/calendar/ritu", applyExtras(qNone(input), input, [["date", "date"], ["tz", "tz"], ["ayanamsa", "ayanamsa"], ["lang", "lang"], ["lang", "locale"]]), opts);
418
418
  }
419
419
  /** Get the Samvatsara (Jupiter year) name for a given year — the 60-year Jupiter cycle used in Hindu astrology (Prabhava, Vibhava, Shukla, … Akshaya). */
420
420
  samvatsara(input, opts) {
421
- return this._c.request("/v1/calendar/samvatsara", applyExtras(qNone(input), input, [["date", "date"], ["tz", "tz"], ["lang", "lang"], ["lang", "locale"]]), opts);
421
+ return this._c.request("/v1/calendar/samvatsara", applyExtras(qNone(input), input, [["date", "date"], ["tz", "tz"], ["ayanamsa", "ayanamsa"], ["lang", "lang"], ["lang", "locale"]]), opts);
422
422
  }
423
423
  /** Equinoxes and solstices of a year — exact moment (UTC + local), the ayana that begins (tropical Dakshinayana at the June solstice, tropical Uttarayana at the December solstice; the panchang's Uttarayana is Makara Sankranti), and with lat/lon the sunrise, sunset and day length at that place. */
424
424
  solstices(input, opts) {
@@ -550,9 +550,9 @@ var Dasha = class {
550
550
  charAntar(input, opts) {
551
551
  return this._c.request(buildPath("/v1/dasha/char/{md}/{ad}", input, ["md", "ad"]), applyExtras(qBirth(input), input, [["lang", "lang"], ["lang", "locale"]]), opts);
552
552
  }
553
- /** Currently running Char Dasha (Jaimini) period stack — active mahadasha and antardasha signs with date windows. */
553
+ /** Currently running Char Dasha (Jaimini) period stack — active mahadasha and antardasha signs with date windows (optionally at a custom moment `at`, UTC). */
554
554
  charCurrent(input, opts) {
555
- return this._c.request("/v1/dasha/char/current", applyExtras(qBirth(input), input, [["lang", "lang"], ["lang", "locale"]]), opts);
555
+ return this._c.request("/v1/dasha/char/current", applyExtras(qBirth(input), input, [["at", "at"], ["lang", "lang"], ["lang", "locale"]]), opts);
556
556
  }
557
557
  /** Antardashas inside one Char Dasha mahadasha sign (md = sign name, e.g. 'leo'). */
558
558
  charMaha(input, opts) {
@@ -693,9 +693,9 @@ var Lalkitab = class {
693
693
  dasha(input, opts) {
694
694
  return this._c.request("/v1/lalkitab/dasha", applyExtras(qBirth(input), input, [["lang", "lang"], ["lang", "locale"]]), opts);
695
695
  }
696
- /** Currently active Lal Kitab dasha planet and period window. */
696
+ /** Currently active Lal Kitab dasha planet and period window (optionally at a custom moment `at`, UTC). */
697
697
  dashaCurrent(input, opts) {
698
- return this._c.request("/v1/lalkitab/dasha/current", applyExtras(qBirth(input), input, [["lang", "lang"], ["lang", "locale"]]), opts);
698
+ return this._c.request("/v1/lalkitab/dasha/current", applyExtras(qBirth(input), input, [["at", "at"], ["lang", "lang"], ["lang", "locale"]]), opts);
699
699
  }
700
700
  };
701
701
 
@@ -810,9 +810,9 @@ var Muhurta = class {
810
810
  constructor(_c) {
811
811
  this._c = _c;
812
812
  }
813
- /** Best-scoring general muhurta window in a date range. Each `factors[]` item has a stable English `id` (e.g. `Tithi`, `RahuKaal`); `name` and `value` follow `lang`. */
813
+ /** Best-scoring muhurta windows in a date range. `purpose` is `general` (default), `vivah`, `graha_pravesh` or `naamkaran`; `topN` (1-20, default 5) sets how many windows come back; `birthDate` (YYYY-MM-DD) weights the windows by the person's tara bala and chandra bala. Each `factors[]` item has a stable English `id` (e.g. `Tithi`, `RahuKaal`); `name` and `value` follow `lang`. */
814
814
  bestTime(input, opts) {
815
- return this._c.request("/v1/muhurta/best-time", applyExtras(qMuhurta(input), input, [["lang", "lang"], ["lang", "locale"]]), opts);
815
+ return this._c.request("/v1/muhurta/best-time", applyExtras(qMuhurta(input), input, [["purpose", "purpose"], ["topN", "top_n"], ["birthDate", "birth_date"], ["ayanamsa", "ayanamsa"], ["lang", "lang"], ["lang", "locale"]]), opts);
816
816
  }
817
817
  /** Compute Chandra Bala — the Moon's strength relative to a person's natal Moon sign on a given date. */
818
818
  chandraBala(input, opts) {
@@ -1192,11 +1192,11 @@ var PlanetMoments = class {
1192
1192
  }
1193
1193
  /** Find the combustion window for a planet — the date range when the planet is too close to the Sun (within classical combust limits) and loses strength. */
1194
1194
  combustionWindow(input, opts) {
1195
- return this._c.request("/v1/planet-moments/combustion-window", applyExtras(qNone(input), input, [["planet", "planet"], ["date", "date"], ["time", "time"], ["tz", "tz"], ["maxDays", "max_days"], ["lang", "lang"], ["lang", "locale"]]), opts);
1195
+ return this._c.request("/v1/planet-moments/combustion-window", applyExtras(qNone(input), input, [["planet", "planet"], ["date", "date"], ["time", "time"], ["tz", "tz"], ["maxDays", "max_days"], ["ayanamsa", "ayanamsa"], ["lang", "lang"], ["lang", "locale"]]), opts);
1196
1196
  }
1197
1197
  /** A planet's sign ingresses (sankranti) in a date range. */
1198
1198
  ingress(input, opts) {
1199
- return this._c.request("/v1/planet-moments/ingress", applyExtras(qNone(input), input, [["planet", "planet"], ["date", "date"], ["time", "time"], ["tz", "tz"], ["maxDays", "max_days"], ["lang", "lang"], ["lang", "locale"]]), opts);
1199
+ return this._c.request("/v1/planet-moments/ingress", applyExtras(qNone(input), input, [["planet", "planet"], ["date", "date"], ["time", "time"], ["tz", "tz"], ["maxDays", "max_days"], ["ayanamsa", "ayanamsa"], ["lang", "lang"], ["lang", "locale"]]), opts);
1200
1200
  }
1201
1201
  /** A planet's retrograde windows (station retro -> station direct) in a date range. */
1202
1202
  retrogradeWindow(input, opts) {
@@ -1303,9 +1303,9 @@ var Reports = class {
1303
1303
  horoscopeMonthly(input, opts) {
1304
1304
  return this._c.request("/v1/reports/horoscope/monthly", applyExtras(qRashi(input), input, [["month", "month"], ["lang", "lang"], ["lang", "locale"]]), opts);
1305
1305
  }
1306
- /** Generate a detailed weekly horoscope report for a Moon sign — structured report covering the week's planetary movement, day-by-day highlights, and focus areas. */
1306
+ /** Generate a detailed weekly horoscope report for a Moon sign — structured report covering the week's planetary movement, day-by-day highlights, and focus areas. `week` is an ISO week such as `2026-W47` (default: the current week). */
1307
1307
  horoscopeWeekly(input, opts) {
1308
- return this._c.request("/v1/reports/horoscope/weekly", applyExtras(qRashi(input), input, [["lang", "lang"], ["lang", "locale"]]), opts);
1308
+ return this._c.request("/v1/reports/horoscope/weekly", applyExtras(qRashi(input), input, [["week", "week"], ["lang", "lang"], ["lang", "locale"]]), opts);
1309
1309
  }
1310
1310
  /** Generate the Brihad (comprehensive) Kundli report — the most detailed birth chart report covering chart analysis, all divisional charts (D1–D60), planetary strengths (Shadbala), ashtakavarga, all dashas, yogas, doshas, remedies, and lifetime predictions. */
1311
1311
  kundliBrihad(input, opts) {
@@ -1479,19 +1479,19 @@ var WesternComposite = class {
1479
1479
  }
1480
1480
  /** Get aspects in the composite (midpoint) chart for two people — shows how the relationship's combined energy is configured. */
1481
1481
  aspects(input, opts) {
1482
- return this._c.request("/v1/western/composite/aspects", qTwoPerson(input), opts);
1482
+ return this._c.request("/v1/western/composite/aspects", applyExtras(qTwoPerson(input), input, [["orbConjunction", "orb_conjunction"], ["orbOpposition", "orb_opposition"], ["orbTrine", "orb_trine"], ["orbSquare", "orb_square"], ["orbSextile", "orb_sextile"], ["compositeMethod", "composite_method"], ["houseSystem", "house_system"]]), opts);
1483
1483
  }
1484
1484
  /** Composite (midpoint) relationship chart. */
1485
1485
  chart(input, opts) {
1486
- return this._c.request("/v1/western/composite/chart", qTwoPerson(input), opts);
1486
+ return this._c.request("/v1/western/composite/chart", applyExtras(qTwoPerson(input), input, [["orbConjunction", "orb_conjunction"], ["orbOpposition", "orb_opposition"], ["orbTrine", "orb_trine"], ["orbSquare", "orb_square"], ["orbSextile", "orb_sextile"], ["rulership", "rulership"], ["compositeMethod", "composite_method"], ["houseSystem", "house_system"]]), opts);
1487
1487
  }
1488
1488
  /** Compute the house cusps of the Composite chart for two people — the midpoint chart combining both natal charts to represent the relationship itself. */
1489
1489
  houses(input, opts) {
1490
- return this._c.request("/v1/western/composite/houses", qTwoPerson(input), opts);
1490
+ return this._c.request("/v1/western/composite/houses", applyExtras(qTwoPerson(input), input, [["rulership", "rulership"], ["compositeMethod", "composite_method"], ["houseSystem", "house_system"]]), opts);
1491
1491
  }
1492
1492
  /** Compute the planet placements in the Composite chart for two people — midpoint positions for all planets in the relationship chart. */
1493
1493
  planets(input, opts) {
1494
- return this._c.request("/v1/western/composite/planets", qTwoPerson(input), opts);
1494
+ return this._c.request("/v1/western/composite/planets", applyExtras(qTwoPerson(input), input, [["compositeMethod", "composite_method"], ["houseSystem", "house_system"]]), opts);
1495
1495
  }
1496
1496
  };
1497
1497
  var WesternDavison = class {
@@ -1500,19 +1500,19 @@ var WesternDavison = class {
1500
1500
  }
1501
1501
  /** Get aspects in the Davison relationship chart. */
1502
1502
  aspects(input, opts) {
1503
- return this._c.request("/v1/western/davison/aspects", qTwoPerson(input), opts);
1503
+ return this._c.request("/v1/western/davison/aspects", applyExtras(qTwoPerson(input), input, [["orbConjunction", "orb_conjunction"], ["orbOpposition", "orb_opposition"], ["orbTrine", "orb_trine"], ["orbSquare", "orb_square"], ["orbSextile", "orb_sextile"], ["houseSystem", "house_system"]]), opts);
1504
1504
  }
1505
1505
  /** Compute the Davison relationship chart — an alternative to the composite chart that uses the midpoint of the two birth times rather than midpoint longitudes. */
1506
1506
  chart(input, opts) {
1507
- return this._c.request("/v1/western/davison/chart", qTwoPerson(input), opts);
1507
+ return this._c.request("/v1/western/davison/chart", applyExtras(qTwoPerson(input), input, [["orbConjunction", "orb_conjunction"], ["orbOpposition", "orb_opposition"], ["orbTrine", "orb_trine"], ["orbSquare", "orb_square"], ["orbSextile", "orb_sextile"], ["rulership", "rulership"], ["houseSystem", "house_system"]]), opts);
1508
1508
  }
1509
1509
  /** Compute the house cusps of the Davison Relationship chart — the chart for the midpoint in time and space between two people's births (an actual chart for a real moment, unlike the composite). */
1510
1510
  houses(input, opts) {
1511
- return this._c.request("/v1/western/davison/houses", qTwoPerson(input), opts);
1511
+ return this._c.request("/v1/western/davison/houses", applyExtras(qTwoPerson(input), input, [["rulership", "rulership"], ["houseSystem", "house_system"]]), opts);
1512
1512
  }
1513
1513
  /** Compute the planet placements in the Davison Relationship chart — all planet positions in the Davison chart's tropical zodiac. */
1514
1514
  planets(input, opts) {
1515
- return this._c.request("/v1/western/davison/planets", qTwoPerson(input), opts);
1515
+ return this._c.request("/v1/western/davison/planets", applyExtras(qTwoPerson(input), input, [["houseSystem", "house_system"]]), opts);
1516
1516
  }
1517
1517
  };
1518
1518
  var WesternDignities = class {
@@ -1656,7 +1656,7 @@ var WesternNatal = class {
1656
1656
  }
1657
1657
  /** Compute the Western (tropical) natal Ascendant — rising sign, degree, and Midheaven in the tropical zodiac. */
1658
1658
  ascendant(input, opts) {
1659
- return this._c.request("/v1/western/natal/ascendant", qWesternNatal(input), opts);
1659
+ return this._c.request("/v1/western/natal/ascendant", applyExtras(qWesternNatal(input), input, [["rulership", "rulership"]]), opts);
1660
1660
  }
1661
1661
  /** Detect classical multi-planet aspect patterns in a natal chart — Grand Trine, T-Square, Grand Cross, Yod (Finger of God), Kite, Mystic Rectangle, Stellium, Grand Sextile. */
1662
1662
  aspectPatterns(input, opts) {
@@ -1664,7 +1664,7 @@ var WesternNatal = class {
1664
1664
  }
1665
1665
  /** All natal aspects with orbs and partile flags. */
1666
1666
  aspects(input, opts) {
1667
- return this._c.request("/v1/western/natal/aspects", qWesternNatal(input), opts);
1667
+ return this._c.request("/v1/western/natal/aspects", applyExtras(qWesternNatal(input), input, [["orbConjunction", "orb_conjunction"], ["orbOpposition", "orb_opposition"], ["orbTrine", "orb_trine"], ["orbSquare", "orb_square"], ["orbSextile", "orb_sextile"]]), opts);
1668
1668
  }
1669
1669
  /** A single asteroid by MPC number. */
1670
1670
  asteroid(input, opts) {
@@ -1680,7 +1680,7 @@ var WesternNatal = class {
1680
1680
  }
1681
1681
  /** Western (tropical) natal chart: planets, ascendant, MC, houses and aspects. */
1682
1682
  chart(input, opts) {
1683
- return this._c.request("/v1/western/natal/chart", qWesternNatal(input), opts);
1683
+ return this._c.request("/v1/western/natal/chart", applyExtras(qWesternNatal(input), input, [["orbConjunction", "orb_conjunction"], ["orbOpposition", "orb_opposition"], ["orbTrine", "orb_trine"], ["orbSquare", "orb_square"], ["orbSextile", "orb_sextile"], ["rulership", "rulership"]]), opts);
1684
1684
  }
1685
1685
  /** Classify the natal chart into one of the seven Jones planetary distribution patterns: Splash, Bundle, Locomotive, Bowl, Bucket, See-Saw, or Splay. */
1686
1686
  chartShape(input, opts) {
@@ -1712,7 +1712,7 @@ var WesternNatal = class {
1712
1712
  }
1713
1713
  /** Western tropical house cusps + Ascendant and MC. */
1714
1714
  houses(input, opts) {
1715
- return this._c.request("/v1/western/natal/houses", qWesternNatal(input), opts);
1715
+ return this._c.request("/v1/western/natal/houses", applyExtras(qWesternNatal(input), input, [["rulership", "rulership"]]), opts);
1716
1716
  }
1717
1717
  /** Get all Lilith positions: Mean Black Moon Lilith, True Black Moon Lilith, Osculating (Interpolated) Lilith, and asteroid 1181 Lilith. */
1718
1718
  lilithSet(input, opts) {
@@ -1728,7 +1728,7 @@ var WesternNatal = class {
1728
1728
  }
1729
1729
  /** Compute the Midheaven (Medium Coeli, MC) and its tropical sign for a Western birth chart — the career and public reputation point, along with its aspects to natal planets. */
1730
1730
  mc(input, opts) {
1731
- return this._c.request("/v1/western/natal/mc", qWesternNatal(input), opts);
1731
+ return this._c.request("/v1/western/natal/mc", applyExtras(qWesternNatal(input), input, [["rulership", "rulership"]]), opts);
1732
1732
  }
1733
1733
  /** All planet-pair midpoints and activations. */
1734
1734
  midpoints(input, opts) {
@@ -1807,7 +1807,7 @@ var WesternProgressions = class {
1807
1807
  }
1808
1808
  /** Get secondary progressed planet aspects to natal planets — the slow symbolic evolution of the birth chart over time. */
1809
1809
  aspectsToNatal(input, opts) {
1810
- return this._c.request("/v1/western/progressions/aspects-to-natal", applyExtras(qWesternNatal(input), input, [["ageInYears", "age_in_years"]]), opts);
1810
+ return this._c.request("/v1/western/progressions/aspects-to-natal", applyExtras(qWesternNatal(input), input, [["ageInYears", "age_in_years"], ["orbConjunction", "orb_conjunction"], ["orbOpposition", "orb_opposition"], ["orbTrine", "orb_trine"], ["orbSquare", "orb_square"], ["orbSextile", "orb_sextile"]]), opts);
1811
1811
  }
1812
1812
  /** Get the progressed Moon phase — shows what stage of the 29-year progressed lunation cycle you are in (new moon, crescent, first quarter, gibbous, full moon, disseminating, last quarter, balsamic). */
1813
1813
  lunation(input, opts) {
@@ -1824,7 +1824,7 @@ var WesternReturns = class {
1824
1824
  }
1825
1825
  /** Compute the Lunar Return chart — the chart for the exact moment the transiting Moon returns to its natal degree (~every 27.3 days). */
1826
1826
  lunar(input, opts) {
1827
- return this._c.request("/v1/western/returns/lunar", applyExtras(qWesternNatal(input), input, [["from", "from"]]), opts);
1827
+ return this._c.request("/v1/western/returns/lunar", applyExtras(qWesternNatal(input), input, [["from", "from"], ["rulership", "rulership"], ["relocateLat", "relocate_lat"], ["relocateLon", "relocate_lon"]]), opts);
1828
1828
  }
1829
1829
  /** Get the aspects formed between planets in the lunar return chart. */
1830
1830
  lunarAspects(input, opts) {
@@ -1832,7 +1832,7 @@ var WesternReturns = class {
1832
1832
  }
1833
1833
  /** Solar Return chart for a year. */
1834
1834
  solar(input, opts) {
1835
- return this._c.request("/v1/western/returns/solar", applyExtras(qWesternNatal(input), input, [["returnYear", "return_year"]]), opts);
1835
+ return this._c.request("/v1/western/returns/solar", applyExtras(qWesternNatal(input), input, [["returnYear", "return_year"], ["rulership", "rulership"], ["relocateLat", "relocate_lat"], ["relocateLon", "relocate_lon"]]), opts);
1836
1836
  }
1837
1837
  /** Get the aspects formed between planets in the solar return chart — shows which planets are strongly configured in the return year. */
1838
1838
  solarAspects(input, opts) {
@@ -1849,7 +1849,7 @@ var WesternSolarArc = class {
1849
1849
  }
1850
1850
  /** Get solar arc directed planet aspects to natal planets — a predictive technique where all planets advance at the rate of the Sun (~1°/year). */
1851
1851
  aspectsToNatal(input, opts) {
1852
- return this._c.request("/v1/western/solar-arc/aspects-to-natal", applyExtras(qWesternNatal(input), input, [["ageInYears", "age_in_years"]]), opts);
1852
+ return this._c.request("/v1/western/solar-arc/aspects-to-natal", applyExtras(qWesternNatal(input), input, [["ageInYears", "age_in_years"], ["orbConjunction", "orb_conjunction"], ["orbOpposition", "orb_opposition"], ["orbTrine", "orb_trine"], ["orbSquare", "orb_square"], ["orbSextile", "orb_sextile"]]), opts);
1853
1853
  }
1854
1854
  /** Solar Arc directed planetary positions at an age. */
1855
1855
  planets(input, opts) {
@@ -1862,15 +1862,15 @@ var WesternSynastry = class {
1862
1862
  }
1863
1863
  /** Cross-chart synastry aspects between two charts. */
1864
1864
  aspects(input, opts) {
1865
- return this._c.request("/v1/western/synastry/aspects", qTwoPerson(input), opts);
1865
+ return this._c.request("/v1/western/synastry/aspects", applyExtras(qTwoPerson(input), input, [["orbConjunction", "orb_conjunction"], ["orbOpposition", "orb_opposition"], ["orbTrine", "orb_trine"], ["orbSquare", "orb_square"], ["orbSextile", "orb_sextile"], ["houseSystem", "house_system"]]), opts);
1866
1866
  }
1867
1867
  /** Get the full N×M synastry aspect grid between two natal charts — every planet in chart A aspecting every planet in chart B. */
1868
1868
  grid(input, opts) {
1869
- return this._c.request("/v1/western/synastry/grid", qTwoPerson(input), opts);
1869
+ return this._c.request("/v1/western/synastry/grid", applyExtras(qTwoPerson(input), input, [["orbConjunction", "orb_conjunction"], ["orbOpposition", "orb_opposition"], ["orbTrine", "orb_trine"], ["orbSquare", "orb_square"], ["orbSextile", "orb_sextile"], ["houseSystem", "house_system"]]), opts);
1870
1870
  }
1871
1871
  /** Synastry compatibility score and breakdown. */
1872
1872
  score(input, opts) {
1873
- return this._c.request("/v1/western/synastry/score", qTwoPerson(input), opts);
1873
+ return this._c.request("/v1/western/synastry/score", applyExtras(qTwoPerson(input), input, [["orbConjunction", "orb_conjunction"], ["orbOpposition", "orb_opposition"], ["orbTrine", "orb_trine"], ["orbSquare", "orb_square"], ["orbSextile", "orb_sextile"], ["houseSystem", "house_system"]]), opts);
1874
1874
  }
1875
1875
  };
1876
1876
  var WesternTransits = class {
@@ -1891,7 +1891,7 @@ var WesternTransits = class {
1891
1891
  }
1892
1892
  /** All current transiting aspects to natal planets. */
1893
1893
  toNatal(input, opts) {
1894
- return this._c.request("/v1/western/transits/to-natal", qNatalTransit(input), opts);
1894
+ return this._c.request("/v1/western/transits/to-natal", applyExtras(qNatalTransit(input), input, [["orbConjunction", "orb_conjunction"], ["orbOpposition", "orb_opposition"], ["orbTrine", "orb_trine"], ["orbSquare", "orb_square"], ["orbSextile", "orb_sextile"]]), opts);
1895
1895
  }
1896
1896
  };
1897
1897
  var WesternZodiacalReleasing = class {
@@ -1975,7 +1975,7 @@ var Resources = class {
1975
1975
  };
1976
1976
 
1977
1977
  // src/client.ts
1978
- var VERSION = "0.2.0";
1978
+ var VERSION = "0.9.0";
1979
1979
  var DEFAULT_BASE_URL = "https://api.lifeastroapi.com";
1980
1980
  function resolveConfig(options) {
1981
1981
  const opts = typeof options === "string" ? { apiKey: options } : options ?? {};