lifeastroapi 0.4.0 → 0.5.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.cts CHANGED
@@ -142,6 +142,36 @@ interface NatalTransitInput {
142
142
  /** Transit timezone (IANA or fixed offset). */
143
143
  tz: string;
144
144
  }
145
+ /**
146
+ * Natal chart for the window endpoints. Only date, time and tz are needed for
147
+ * the natal Moon; lat/lon add the lagna-based fields where an endpoint has them.
148
+ */
149
+ interface NatalWindowBirth {
150
+ /** ISO date, `YYYY-MM-DD`. */
151
+ date: string;
152
+ /** 24-hour time, `HH:MM`. */
153
+ time: string;
154
+ /** IANA name (`Asia/Kolkata`) or fixed offset (`+05:30`). */
155
+ tz: string;
156
+ lat?: number;
157
+ lon?: number;
158
+ }
159
+ /**
160
+ * Natal chart (sent as `birth.*`) plus a date range: `from` (`YYYY-MM-DD`,
161
+ * local midnight in `tz`, default now) and `tz`, the zone of every `*_local`
162
+ * value in the response (default the birth tz).
163
+ */
164
+ interface NatalWindowInput {
165
+ birth: NatalWindowBirth;
166
+ from?: string;
167
+ tz?: string;
168
+ }
169
+ /** Like {@link NatalWindowInput}, but the natal chart is optional. */
170
+ interface OptionalNatalWindowInput {
171
+ birth?: NatalWindowBirth;
172
+ from?: string;
173
+ tz?: string;
174
+ }
145
175
  /** Low-level query value. */
146
176
  type QueryValue = string | number | boolean | null | undefined;
147
177
  type QueryParams = Record<string, QueryValue>;
@@ -164,17 +194,11 @@ declare class Ashtakavarga {
164
194
  planet: string;
165
195
  }, opts?: RequestOptions): Promise<T>;
166
196
  /** Get Kaksha (sub-division) level Ashtakavarga analysis — divides each sign into 8 equal 3°45′ segments, each ruled by a graha. */
167
- kaksha<T = unknown>(input: BirthInput & VedicMomentSettings & {
168
- date: string;
169
- tz: string;
170
- }, opts?: RequestOptions): Promise<T>;
197
+ kaksha<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
171
198
  /** Get the Sarvashtakavarga table — the combined 12-sign benefic-point grid from all 9 grahas. */
172
199
  sarva<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
173
200
  /** Score current (or a given date's) planetary transits against a natal chart using Ashtakavarga benefic points. */
174
- transitScore<T = unknown>(input: BirthInput & VedicMomentSettings & {
175
- date: string;
176
- tz: string;
177
- }, opts?: RequestOptions): Promise<T>;
201
+ transitScore<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
178
202
  }
179
203
 
180
204
  declare class Calendar {
@@ -237,6 +261,11 @@ declare class Chart {
237
261
  divisional<T = unknown>(input: BirthInput & VedicBirthSettings & {
238
262
  varga: string;
239
263
  }, opts?: RequestOptions): Promise<T>;
264
+ /** Doshas in a birth chart as data (20 credits): kaalsarp, mangal (from lagna, Moon and Venus with cancellation), pitra, combust, debilitation (with neecha bhanga), retrograde, gandanta, grahan, papakartari, mrityu bhaga, guru chandal, visha kanya, ganda moola. Same item fields as chart.yogas. all=true also lists absent ids. Ids only, no text: planets sun..ketu, sign_index 0-based (Aries=0), house 1-based whole-sign from the lagna, nakshatra index 0-based (Ashwini=0). */
265
+ doshas<T = unknown>(input: BirthInput & VedicBirthSettings & {
266
+ all?: boolean;
267
+ gender?: string;
268
+ }, opts?: RequestOptions): Promise<T>;
240
269
  /** Ghatak Chakra (inauspicious indicators) for the chart. */
241
270
  ghatak<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
242
271
  /** Identify Graha Yuddha (planetary war) in a birth chart — occurs when two visible planets are within 1° of each other. */
@@ -253,6 +282,12 @@ declare class Chart {
253
282
  kpSublord<T = unknown>(input: BirthInput & VedicBirthSettings & {
254
283
  planet: string;
255
284
  }, opts?: RequestOptions): Promise<T>;
285
+ /** Whole birth chart as data in one call (50 credits): lagna; planets with sign, degree, house, nakshatra, pada, retrograde, combust, dignity, neecha bhanga, vargottama, houses ruled, shadbala, avastha and varga placements; houses with sign, lord, SAV bindus, bhava bala, occupants and aspecting planets; Jaimini chara karakas; avakhada. vargas: comma list (default D9, max 16, D1 rejected). include: shadbala, bhavabala, ashtakvarga, aspects, avastha, karakas, avakhada, yogas or all (default all but yogas). gender narrows Mahabhagya. Ids only, no text: planets sun..ketu, sign_index 0-based (Aries=0), house 1-based whole-sign from the lagna, nakshatra index 0-based (Ashwini=0). Anything not computable is in skipped. */
286
+ kundliFacts<T = unknown>(input: BirthInput & VedicBirthSettings & {
287
+ vargas?: string;
288
+ include?: string;
289
+ gender?: string;
290
+ }, opts?: RequestOptions): Promise<T>;
256
291
  /** Birth (Janma) nakshatra and pada. */
257
292
  nakshatra<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
258
293
  /** Navamsa (D9) divisional chart — convenience alias for divisional('D9'). */
@@ -263,12 +298,23 @@ declare class Chart {
263
298
  }, opts?: RequestOptions): Promise<T>;
264
299
  /** All 9 grahas with sign, degree, nakshatra, house, retrograde, dignity, combustion and speed. */
265
300
  planets<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
301
+ /** Birth-time sensitivity (20 credits): for D1 and each varga (default D9,D10,D24) the lagna sign at birth and how many minutes before/after it stays the same, with the neighbouring signs; the same for the Moon's nakshatra and pada; planet sign changes inside the window. window: half-width in minutes (default 120, max 180). Use it to tell users how much a birth-time error matters. Every instant comes as *_local (RFC 3339 with offset) and *_jd (Julian Day, UT); fields that cannot be computed are listed in skipped. */
302
+ sensitivity<T = unknown>(input: BirthInput & VedicBirthSettings & {
303
+ window?: number;
304
+ vargas?: string;
305
+ topocentricMoon?: boolean;
306
+ }, opts?: RequestOptions): Promise<T>;
266
307
  /** Shadbala (six-fold strength) for all 7 planets with components. */
267
308
  shadbala<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
268
309
  /** One shadbala component (sthana|dig|kala|chesta|naisargika|drik) for all planets. */
269
310
  shadbalaComponent<T = unknown>(input: BirthInput & VedicBirthSettings & {
270
311
  component: string;
271
312
  }, opts?: RequestOptions): Promise<T>;
313
+ /** Yogas present in a birth chart as data (20 credits), from the same detectors as narrative.yogas: id, kind, category, present, planets, houses, strength, cancelled + cancel_reasons, variant, axes, sub_ids, source, details. Includes neecha_bhanga.<planet> and raja_yoga.kendra_trikona. all=true also lists every absent catalogue id with present:false. Ids only, no text: planets sun..ketu, sign_index 0-based (Aries=0), house 1-based whole-sign from the lagna, nakshatra index 0-based (Ashwini=0). */
314
+ yogas<T = unknown>(input: BirthInput & VedicBirthSettings & {
315
+ all?: boolean;
316
+ gender?: string;
317
+ }, opts?: RequestOptions): Promise<T>;
272
318
  }
273
319
 
274
320
  declare class Dasha {
@@ -478,8 +524,16 @@ declare class Milan {
478
524
  }, opts?: RequestOptions): Promise<T>;
479
525
  /** Just the Ashtakoota (Guna Milan) total score and verdict. */
480
526
  ashtakootaTotal<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
481
- /** Check Dasha synchrony between two partners — are they running compatible mahadasha lords at the same time? Good dasha synchrony indicates the couple will flourish together during major life events. */
482
- dashaSync<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
527
+ /** Current Vimshottari Maha Dasha of both partners and whether they overlap (20 credits); date/time/tz set the check moment (default now). timeline=true adds both partners' MD/AD periods on one aligned timeline from from for years (default 10, max 30), each span with md, ad and the running AD's start/end. marriageWindows=true (implies timeline) tags each span favourable, neutral or avoid with reason ids (rule D-MarriageWindows1). Each partner's Moon uses the ayanamsa of their own birth moment, so dates match dasha.vimshottari. */
528
+ dashaSync<T = unknown>(input: BoyGirlInput & VedicMomentSettings & {
529
+ timeline?: boolean;
530
+ years?: number;
531
+ from?: string;
532
+ marriageWindows?: boolean;
533
+ date?: string;
534
+ time?: string;
535
+ tz?: string;
536
+ }, opts?: RequestOptions): Promise<T>;
483
537
  /** Check Dhan Yog (wealth yoga) for a single person's chart — assesses 2nd/11th house lord strength and Jupiter placement for prosperity. */
484
538
  dhanYog<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
485
539
  /** Assess longevity for a single person's chart — classical analysis of lagna, 8th house, and Moon sign longevity indicators. */
@@ -492,12 +546,20 @@ declare class Milan {
492
546
  nadiDosha<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
493
547
  /** Check Navamsa compatibility — compares the D9 (Navamsa) chart placements of both partners for deeper marriage harmony beyond the D1 chart. */
494
548
  navamsaCompat<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
549
+ /** Couple chart overlay as data (20 credits): each partner's grahas in the other's whole-sign houses (with conjunct grahas), same-sign and same-nakshatra pairs, Moon sign relation (e.g. "2/12"), and each lagna lord's placement in the other's chart (sign, house, dignity, combust, retro). Each partner's chart uses the ayanamsa of their own birth moment. Ids only, no text: planets sun..ketu, sign_index 0-based (Aries=0), house 1-based whole-sign from the lagna, nakshatra index 0-based (Ashwini=0). */
550
+ overlay<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
495
551
  /** Check Santan Yog for a single person's chart — assesses 5th house lord and Jupiter placement to indicate prospects for children. */
496
552
  santanYog<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
497
553
  /** Check Shani Dosha for a single person's chart — Saturn in 1st, 4th, 7th, 10th, or 12th house from lagna. */
498
554
  shaniDosha<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
499
555
  /** Check Stree Dirgha — the distance from bride's nakshatra to groom's must be more than 9 nakshatras for a beneficial match (indicates the groom will lead a longer, more prosperous life than the bride expected). */
500
556
  streeDirgha<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
557
+ /** Couple matching data in one call (60 credits), numbers identical to the separate routes: ashtakoota (every koota), navamsa_compat, mangal_dosha of both plus pair status, seventh_house facts of both (7th sign, occupants, 7th lord, Venus, Jupiter, D9 7th, D7 5th), and sade_sati windows of both for 10 years from from. include=kundli_facts adds both full charts. Ids only, no text: planets sun..ketu, sign_index 0-based (Aries=0), house 1-based whole-sign from the lagna, nakshatra index 0-based (Ashwini=0). */
558
+ summary<T = unknown>(input: BoyGirlInput & VedicMomentSettings & {
559
+ from?: string;
560
+ tz?: string;
561
+ include?: string;
562
+ }, opts?: RequestOptions): Promise<T>;
501
563
  /** Vivah Phal (marriage-outcome) assessment for one chart. */
502
564
  vivahPhal<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
503
565
  }
@@ -542,10 +604,8 @@ declare class Narrative {
542
604
  careerOutlook<T = unknown>(input: BirthInput & VedicBirthSettings & {
543
605
  lang?: string;
544
606
  }, opts?: RequestOptions): Promise<T>;
545
- /** Get the Dasha Phal (period interpretation) narrative for the currently running Vimshottari Mahadasha + Antardasha combination — a human-readable explanation of what this dasha pair typically brings and how it interacts with the natal chart. */
546
- dashaPhal<T = unknown>(input: BirthInput & VedicMomentSettings & {
547
- date?: string;
548
- tz?: string;
607
+ /** Get the Dasha Phal (period interpretation) narrative for the Vimshottari dasha running at the given moment — Mahadasha, Antardasha and Pratyantar down to the sookshma and prana levels, plus dasha-sandhi sections when a period change is near. `birth` is the natal chart; date/time/tz are the moment to read. */
608
+ dashaPhal<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
549
609
  lang?: string;
550
610
  }, opts?: RequestOptions): Promise<T>;
551
611
  /** Get narrative interpretations for a specific dasha combination — pass mahadasha lord (and optionally antardasha lord) to get the meaning of that specific period for the natal chart. */
@@ -617,7 +677,7 @@ declare class Narrative {
617
677
  marriageOutlook<T = unknown>(input: BirthInput & VedicBirthSettings & {
618
678
  lang?: string;
619
679
  }, opts?: RequestOptions): Promise<T>;
620
- /** Get a narrative compatibility analysis for a couple — goes beyond the numeric Ashtakoota score with a written interpretation of compatibility across all factors (guna milan, mangal dosha, dashas, navamsa). */
680
+ /** Get a narrative compatibility analysis for a couple — a written reading of the Ashtakoota result (verdict and each koota; Tara and Graha Maitri are scored both ways) plus synastry sections from the graha signs of both charts. */
621
681
  milan<T = unknown>(input: {
622
682
  boyDate: string;
623
683
  boyTime: string;
@@ -653,6 +713,12 @@ declare class Narrative {
653
713
  planetsInSigns<T = unknown>(input: BirthInput & VedicBirthSettings & {
654
714
  lang?: string;
655
715
  }, opts?: RequestOptions): Promise<T>;
716
+ /** Get a Prashna (horary) narrative for the moment and place a question is asked — the Prashna lagna and Moon sections, plus the topic reading for the Prashna lagna. topic: career, financial, health, litigation, marriage, missing_person, property or travel; or questionHouse 1-12 when topic is not given (with neither, only the lagna and Moon sections). An unknown topic or a house outside 1-12 returns 400. */
717
+ prashna<T = unknown>(input: MomentInput & VedicMomentSettings & {
718
+ topic?: string;
719
+ questionHouse?: number;
720
+ lang?: string;
721
+ }, opts?: RequestOptions): Promise<T>;
656
722
  /** Get a holistic birth chart profile narrative — an executive summary of the entire chart covering lagna, Moon sign, key planetary strengths/weaknesses, dominant yogas, current dasha, and life-theme highlights in a single comprehensive reading. */
657
723
  profile<T = unknown>(input: BirthInput & VedicBirthSettings & {
658
724
  lang?: string;
@@ -667,21 +733,15 @@ declare class Narrative {
667
733
  lang?: string;
668
734
  }, opts?: RequestOptions): Promise<T>;
669
735
  /** Get a narrative of all past and future Sade Sati periods for a birth chart — written descriptions of each 7.5-year Saturn transit cycle with dates, life themes expected, and which phase (rising/peak/setting) the person experienced. */
670
- sadeSatiHistory<T = unknown>(input: BirthInput & VedicMomentSettings & {
671
- date?: string;
672
- tz?: string;
736
+ sadeSatiHistory<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
673
737
  lang?: string;
674
738
  }, opts?: RequestOptions): Promise<T>;
675
739
  /** Get a narrative interpretation of the current Sade Sati phase (rising, peak, or setting) — what the current phase typically brings and remedies. */
676
- sadeSatiPhase<T = unknown>(input: BirthInput & VedicMomentSettings & {
677
- date?: string;
678
- tz?: string;
740
+ sadeSatiPhase<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
679
741
  lang?: string;
680
742
  }, opts?: RequestOptions): Promise<T>;
681
743
  /** Get the current Sade Sati status with narrative context — whether the person is in Sade Sati, which phase, start/end dates, and a written description of the current transit's meaning for their Moon sign. */
682
- sadeSatiStatus<T = unknown>(input: BirthInput & VedicMomentSettings & {
683
- date?: string;
684
- tz?: string;
744
+ sadeSatiStatus<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
685
745
  lang?: string;
686
746
  }, opts?: RequestOptions): Promise<T>;
687
747
  /** Get a narrative interpretation of the natal Sun sign (Surya Rashi) — covers ego, identity, father, authority, vitality, and the life-purpose themes associated with the Sun's sidereal sign placement. */
@@ -698,15 +758,11 @@ declare class Narrative {
698
758
  lang?: string;
699
759
  }, opts?: RequestOptions): Promise<T>;
700
760
  /** Get a narrative of the Double Transit analysis — written explanation of which life events the current Jupiter-Saturn joint transit is activating in the chart, and when the confluence is strongest. */
701
- transitDouble<T = unknown>(input: BirthInput & VedicMomentSettings & {
702
- date?: string;
703
- tz?: string;
761
+ transitDouble<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
704
762
  lang?: string;
705
763
  }, opts?: RequestOptions): Promise<T>;
706
- /** Get the Transit Phal (gochar results) narrative — a written analysis of all current major planetary transits over the natal chart, their house positions from Moon, and the classical effects expected from each transit. */
707
- transitPhal<T = unknown>(input: BirthInput & VedicMomentSettings & {
708
- date?: string;
709
- tz?: string;
764
+ /** Get the Transit Phal (gochar results) narrative — the slow grahas (Mars, Jupiter, Saturn, Rahu, Ketu) by sign, their transit counted from the natal Moon and from the natal lagna, Sade Sati while it runs, the Sun's transit house, and Jupiter/Saturn/Rahu passing over natal grahas. `birth` is the natal chart (its lat/lon are sent as the birth place for the lagna sections); date/time/tz are the transit moment. */
765
+ transitPhal<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
710
766
  lang?: string;
711
767
  }, opts?: RequestOptions): Promise<T>;
712
768
  /** Get a narrative of the key themes for the current Varshaphal (solar-return) year — written analysis of the annual chart's varsha lord, muntha, annual lagna, and tajika yogas as a prediction for the year's major themes. */
@@ -936,6 +992,14 @@ declare class Remedies {
936
992
  id: string;
937
993
  locale?: string;
938
994
  }, opts?: RequestOptions): Promise<T>;
995
+ /** Remedies for one graha by reason (10 credits): a filter over the remedy catalogue (same rows and languages as remedies.vedic). reason: debilitated, combust, dusthana, weak_shadbala, dasha or dosha:<id> (graha is optional with dosha:<id>). Each item adds kind (mantra, daan, vrat, pooja, pilgrimage, yantra, rudraksha), weekday (0 = Sunday, or null) and matched_by. Free kinds by default; include adds pooja, pilgrimage, yantra, rudraksha; category limits to one catalogue category. */
996
+ forGraha<T = unknown>(input?: {
997
+ graha?: string;
998
+ reason?: string;
999
+ include?: string;
1000
+ category?: string;
1001
+ lang?: string;
1002
+ }, opts?: RequestOptions): Promise<T>;
939
1003
  /** Lal Kitab remedies for a specific planet-in-house placement (e.g. saturn in house 8). */
940
1004
  lalkitabForPlacement<T = unknown>(input: {
941
1005
  planet: string;
@@ -1094,18 +1158,24 @@ declare class Transit {
1094
1158
  positions<T = unknown>(input?: InstantInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1095
1159
  /** Saturn Sade Sati status (rising/peak/setting) relative to the birth Moon. */
1096
1160
  sadeSati<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1097
- /** Check whether a person is currently in Small Panoti (Ashtama Shani) — the 2.5-year Saturn transit through the 8th house from natal Moon, considered challenging. */
1098
- smallPanoti<T = unknown>(input: BirthInput & VedicMomentSettings & {
1099
- date?: string;
1100
- time?: string;
1101
- tz?: string;
1161
+ /** Sade Sati and Dhaiya windows from the natal Moon (20 credits): intervals (one per stay of Saturn in a sign, kind sade_sati with phase rising/peak/setting, dhaiya_4 kantak or dhaiya_8 ashtama, exact ingress times, retro_reentry), cycles (merged passes with phase spans) and at_from (status at from). from defaults to now, years 25 (max 60); includePast starts at birth. Every instant comes as *_local (RFC 3339 with offset) and *_jd (Julian Day, UT); fields that cannot be computed are listed in skipped. */
1162
+ sadeSatiWindows<T = unknown>(input: NatalWindowInput & VedicMomentSettings & {
1163
+ years?: number;
1164
+ includePast?: boolean;
1102
1165
  }, opts?: RequestOptions): Promise<T>;
1166
+ /** Check whether a person is currently in Small Panoti (Ashtama Shani) — the 2.5-year Saturn transit through the 8th house from natal Moon, considered challenging. */
1167
+ smallPanoti<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1103
1168
  /** Get the complete history and future windows of Small Panoti (Ashtama Shani) for a natal chart — all past and upcoming 2.5-year periods when Saturn transits the 8th house from natal Moon. */
1104
1169
  smallPanotiHistory<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1105
1170
  /** Compute Tara Bala for today's transiting Moon relative to a natal chart — rates the day as Janma/Sampat/Vipat/Kshema/Pratyak/Sadhana/Vadha/Mitra/Param-Mitra tara. */
1106
1171
  tarabala<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1107
1172
  /** Check Vedha (transit obstruction) for a natal chart — certain house transits are blocked (vedha'd) by another planet transiting a specific opposing house simultaneously. */
1108
1173
  vedha<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1174
+ /** Every stay of one planet (sun..ketu) in a sidereal sign that overlaps [from, from + years] (20 credits), with exact ingress times, retro_reentry and retrograde_at_start. With birth (date, time, tz) each window has house_from_moon; with birth lat/lon also house_from_lagna. years: default 25 / max 60 for jupiter, saturn, rahu, ketu; 5 / 20 for sun, mercury, venus, mars; 1 / 2 for moon. Every instant comes as *_local (RFC 3339 with offset) and *_jd (Julian Day, UT); fields that cannot be computed are listed in skipped. */
1175
+ windows<T = unknown>(input: OptionalNatalWindowInput & VedicMomentSettings & {
1176
+ planet: string;
1177
+ years?: number;
1178
+ }, opts?: RequestOptions): Promise<T>;
1109
1179
  }
1110
1180
 
1111
1181
  declare class Varshaphal {
@@ -1119,7 +1189,7 @@ declare class Varshaphal {
1119
1189
  harshaBala<T = unknown>(input: BirthInput & VedicBirthSettings & {
1120
1190
  year: number;
1121
1191
  }, opts?: RequestOptions): Promise<T>;
1122
- /** Get the Varsha Lord (year ruler) for an annual chart — the planet that rules the Varshaphal year based on the Tajika system. */
1192
+ /** Get the Varsha Lord (Varshesha, year ruler) for an annual chart, chosen by the Tajika Panchadhikari rule from the five office-bearers (Munthesh, Janmesh, Varsha Lagnesh, Trirashipati, Dina/Ratripati); the response also lists the candidates and the hora lord of the return. */
1123
1193
  lord<T = unknown>(input: BirthInput & VedicBirthSettings & {
1124
1194
  year: number;
1125
1195
  }, opts?: RequestOptions): Promise<T>;
@@ -1773,4 +1843,4 @@ declare class LifeAstroConnectionError extends LifeAstroError {
1773
1843
  * @packageDocumentation
1774
1844
  */
1775
1845
 
1776
- export { type ApiErrorBody, AuthenticationError, type Ayanamsa, BadRequestError, type BirthInput, type BoyGirlInput, type ClientCore, type DateRangeInput, type FetchLike, type HouseSystem, LifeAstro, LifeAstroConnectionError, LifeAstroError, type LifeAstroOptions, type Locale, type MomentInput, type MuhurtaInput, type NatalTransitInput, NotFoundError, type NumerologyInput, PaymentRequiredError, PermissionError, type QueryParams, type QueryValue, type RashiInput, RateLimitError, type RequestOptions, type ResponseEnvelope, type ResponseMeta, ServerError, type TwoPersonInput, VERSION, type VedicBirthSettings, type VedicMomentSettings, type WesternMomentInput, type WesternNatalInput, LifeAstro as default };
1846
+ export { type ApiErrorBody, AuthenticationError, type Ayanamsa, BadRequestError, type BirthInput, type BoyGirlInput, type ClientCore, type DateRangeInput, type FetchLike, type HouseSystem, LifeAstro, LifeAstroConnectionError, LifeAstroError, type LifeAstroOptions, type Locale, type MomentInput, type MuhurtaInput, type NatalTransitInput, type NatalWindowBirth, type NatalWindowInput, NotFoundError, type NumerologyInput, type OptionalNatalWindowInput, PaymentRequiredError, PermissionError, type QueryParams, type QueryValue, type RashiInput, RateLimitError, type RequestOptions, type ResponseEnvelope, type ResponseMeta, ServerError, type TwoPersonInput, VERSION, type VedicBirthSettings, type VedicMomentSettings, type WesternMomentInput, type WesternNatalInput, LifeAstro as default };
package/dist/index.d.ts CHANGED
@@ -142,6 +142,36 @@ interface NatalTransitInput {
142
142
  /** Transit timezone (IANA or fixed offset). */
143
143
  tz: string;
144
144
  }
145
+ /**
146
+ * Natal chart for the window endpoints. Only date, time and tz are needed for
147
+ * the natal Moon; lat/lon add the lagna-based fields where an endpoint has them.
148
+ */
149
+ interface NatalWindowBirth {
150
+ /** ISO date, `YYYY-MM-DD`. */
151
+ date: string;
152
+ /** 24-hour time, `HH:MM`. */
153
+ time: string;
154
+ /** IANA name (`Asia/Kolkata`) or fixed offset (`+05:30`). */
155
+ tz: string;
156
+ lat?: number;
157
+ lon?: number;
158
+ }
159
+ /**
160
+ * Natal chart (sent as `birth.*`) plus a date range: `from` (`YYYY-MM-DD`,
161
+ * local midnight in `tz`, default now) and `tz`, the zone of every `*_local`
162
+ * value in the response (default the birth tz).
163
+ */
164
+ interface NatalWindowInput {
165
+ birth: NatalWindowBirth;
166
+ from?: string;
167
+ tz?: string;
168
+ }
169
+ /** Like {@link NatalWindowInput}, but the natal chart is optional. */
170
+ interface OptionalNatalWindowInput {
171
+ birth?: NatalWindowBirth;
172
+ from?: string;
173
+ tz?: string;
174
+ }
145
175
  /** Low-level query value. */
146
176
  type QueryValue = string | number | boolean | null | undefined;
147
177
  type QueryParams = Record<string, QueryValue>;
@@ -164,17 +194,11 @@ declare class Ashtakavarga {
164
194
  planet: string;
165
195
  }, opts?: RequestOptions): Promise<T>;
166
196
  /** Get Kaksha (sub-division) level Ashtakavarga analysis — divides each sign into 8 equal 3°45′ segments, each ruled by a graha. */
167
- kaksha<T = unknown>(input: BirthInput & VedicMomentSettings & {
168
- date: string;
169
- tz: string;
170
- }, opts?: RequestOptions): Promise<T>;
197
+ kaksha<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
171
198
  /** Get the Sarvashtakavarga table — the combined 12-sign benefic-point grid from all 9 grahas. */
172
199
  sarva<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
173
200
  /** Score current (or a given date's) planetary transits against a natal chart using Ashtakavarga benefic points. */
174
- transitScore<T = unknown>(input: BirthInput & VedicMomentSettings & {
175
- date: string;
176
- tz: string;
177
- }, opts?: RequestOptions): Promise<T>;
201
+ transitScore<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
178
202
  }
179
203
 
180
204
  declare class Calendar {
@@ -237,6 +261,11 @@ declare class Chart {
237
261
  divisional<T = unknown>(input: BirthInput & VedicBirthSettings & {
238
262
  varga: string;
239
263
  }, opts?: RequestOptions): Promise<T>;
264
+ /** Doshas in a birth chart as data (20 credits): kaalsarp, mangal (from lagna, Moon and Venus with cancellation), pitra, combust, debilitation (with neecha bhanga), retrograde, gandanta, grahan, papakartari, mrityu bhaga, guru chandal, visha kanya, ganda moola. Same item fields as chart.yogas. all=true also lists absent ids. Ids only, no text: planets sun..ketu, sign_index 0-based (Aries=0), house 1-based whole-sign from the lagna, nakshatra index 0-based (Ashwini=0). */
265
+ doshas<T = unknown>(input: BirthInput & VedicBirthSettings & {
266
+ all?: boolean;
267
+ gender?: string;
268
+ }, opts?: RequestOptions): Promise<T>;
240
269
  /** Ghatak Chakra (inauspicious indicators) for the chart. */
241
270
  ghatak<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
242
271
  /** Identify Graha Yuddha (planetary war) in a birth chart — occurs when two visible planets are within 1° of each other. */
@@ -253,6 +282,12 @@ declare class Chart {
253
282
  kpSublord<T = unknown>(input: BirthInput & VedicBirthSettings & {
254
283
  planet: string;
255
284
  }, opts?: RequestOptions): Promise<T>;
285
+ /** Whole birth chart as data in one call (50 credits): lagna; planets with sign, degree, house, nakshatra, pada, retrograde, combust, dignity, neecha bhanga, vargottama, houses ruled, shadbala, avastha and varga placements; houses with sign, lord, SAV bindus, bhava bala, occupants and aspecting planets; Jaimini chara karakas; avakhada. vargas: comma list (default D9, max 16, D1 rejected). include: shadbala, bhavabala, ashtakvarga, aspects, avastha, karakas, avakhada, yogas or all (default all but yogas). gender narrows Mahabhagya. Ids only, no text: planets sun..ketu, sign_index 0-based (Aries=0), house 1-based whole-sign from the lagna, nakshatra index 0-based (Ashwini=0). Anything not computable is in skipped. */
286
+ kundliFacts<T = unknown>(input: BirthInput & VedicBirthSettings & {
287
+ vargas?: string;
288
+ include?: string;
289
+ gender?: string;
290
+ }, opts?: RequestOptions): Promise<T>;
256
291
  /** Birth (Janma) nakshatra and pada. */
257
292
  nakshatra<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
258
293
  /** Navamsa (D9) divisional chart — convenience alias for divisional('D9'). */
@@ -263,12 +298,23 @@ declare class Chart {
263
298
  }, opts?: RequestOptions): Promise<T>;
264
299
  /** All 9 grahas with sign, degree, nakshatra, house, retrograde, dignity, combustion and speed. */
265
300
  planets<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
301
+ /** Birth-time sensitivity (20 credits): for D1 and each varga (default D9,D10,D24) the lagna sign at birth and how many minutes before/after it stays the same, with the neighbouring signs; the same for the Moon's nakshatra and pada; planet sign changes inside the window. window: half-width in minutes (default 120, max 180). Use it to tell users how much a birth-time error matters. Every instant comes as *_local (RFC 3339 with offset) and *_jd (Julian Day, UT); fields that cannot be computed are listed in skipped. */
302
+ sensitivity<T = unknown>(input: BirthInput & VedicBirthSettings & {
303
+ window?: number;
304
+ vargas?: string;
305
+ topocentricMoon?: boolean;
306
+ }, opts?: RequestOptions): Promise<T>;
266
307
  /** Shadbala (six-fold strength) for all 7 planets with components. */
267
308
  shadbala<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
268
309
  /** One shadbala component (sthana|dig|kala|chesta|naisargika|drik) for all planets. */
269
310
  shadbalaComponent<T = unknown>(input: BirthInput & VedicBirthSettings & {
270
311
  component: string;
271
312
  }, opts?: RequestOptions): Promise<T>;
313
+ /** Yogas present in a birth chart as data (20 credits), from the same detectors as narrative.yogas: id, kind, category, present, planets, houses, strength, cancelled + cancel_reasons, variant, axes, sub_ids, source, details. Includes neecha_bhanga.<planet> and raja_yoga.kendra_trikona. all=true also lists every absent catalogue id with present:false. Ids only, no text: planets sun..ketu, sign_index 0-based (Aries=0), house 1-based whole-sign from the lagna, nakshatra index 0-based (Ashwini=0). */
314
+ yogas<T = unknown>(input: BirthInput & VedicBirthSettings & {
315
+ all?: boolean;
316
+ gender?: string;
317
+ }, opts?: RequestOptions): Promise<T>;
272
318
  }
273
319
 
274
320
  declare class Dasha {
@@ -478,8 +524,16 @@ declare class Milan {
478
524
  }, opts?: RequestOptions): Promise<T>;
479
525
  /** Just the Ashtakoota (Guna Milan) total score and verdict. */
480
526
  ashtakootaTotal<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
481
- /** Check Dasha synchrony between two partners — are they running compatible mahadasha lords at the same time? Good dasha synchrony indicates the couple will flourish together during major life events. */
482
- dashaSync<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
527
+ /** Current Vimshottari Maha Dasha of both partners and whether they overlap (20 credits); date/time/tz set the check moment (default now). timeline=true adds both partners' MD/AD periods on one aligned timeline from from for years (default 10, max 30), each span with md, ad and the running AD's start/end. marriageWindows=true (implies timeline) tags each span favourable, neutral or avoid with reason ids (rule D-MarriageWindows1). Each partner's Moon uses the ayanamsa of their own birth moment, so dates match dasha.vimshottari. */
528
+ dashaSync<T = unknown>(input: BoyGirlInput & VedicMomentSettings & {
529
+ timeline?: boolean;
530
+ years?: number;
531
+ from?: string;
532
+ marriageWindows?: boolean;
533
+ date?: string;
534
+ time?: string;
535
+ tz?: string;
536
+ }, opts?: RequestOptions): Promise<T>;
483
537
  /** Check Dhan Yog (wealth yoga) for a single person's chart — assesses 2nd/11th house lord strength and Jupiter placement for prosperity. */
484
538
  dhanYog<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
485
539
  /** Assess longevity for a single person's chart — classical analysis of lagna, 8th house, and Moon sign longevity indicators. */
@@ -492,12 +546,20 @@ declare class Milan {
492
546
  nadiDosha<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
493
547
  /** Check Navamsa compatibility — compares the D9 (Navamsa) chart placements of both partners for deeper marriage harmony beyond the D1 chart. */
494
548
  navamsaCompat<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
549
+ /** Couple chart overlay as data (20 credits): each partner's grahas in the other's whole-sign houses (with conjunct grahas), same-sign and same-nakshatra pairs, Moon sign relation (e.g. "2/12"), and each lagna lord's placement in the other's chart (sign, house, dignity, combust, retro). Each partner's chart uses the ayanamsa of their own birth moment. Ids only, no text: planets sun..ketu, sign_index 0-based (Aries=0), house 1-based whole-sign from the lagna, nakshatra index 0-based (Ashwini=0). */
550
+ overlay<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
495
551
  /** Check Santan Yog for a single person's chart — assesses 5th house lord and Jupiter placement to indicate prospects for children. */
496
552
  santanYog<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
497
553
  /** Check Shani Dosha for a single person's chart — Saturn in 1st, 4th, 7th, 10th, or 12th house from lagna. */
498
554
  shaniDosha<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
499
555
  /** Check Stree Dirgha — the distance from bride's nakshatra to groom's must be more than 9 nakshatras for a beneficial match (indicates the groom will lead a longer, more prosperous life than the bride expected). */
500
556
  streeDirgha<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
557
+ /** Couple matching data in one call (60 credits), numbers identical to the separate routes: ashtakoota (every koota), navamsa_compat, mangal_dosha of both plus pair status, seventh_house facts of both (7th sign, occupants, 7th lord, Venus, Jupiter, D9 7th, D7 5th), and sade_sati windows of both for 10 years from from. include=kundli_facts adds both full charts. Ids only, no text: planets sun..ketu, sign_index 0-based (Aries=0), house 1-based whole-sign from the lagna, nakshatra index 0-based (Ashwini=0). */
558
+ summary<T = unknown>(input: BoyGirlInput & VedicMomentSettings & {
559
+ from?: string;
560
+ tz?: string;
561
+ include?: string;
562
+ }, opts?: RequestOptions): Promise<T>;
501
563
  /** Vivah Phal (marriage-outcome) assessment for one chart. */
502
564
  vivahPhal<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
503
565
  }
@@ -542,10 +604,8 @@ declare class Narrative {
542
604
  careerOutlook<T = unknown>(input: BirthInput & VedicBirthSettings & {
543
605
  lang?: string;
544
606
  }, opts?: RequestOptions): Promise<T>;
545
- /** Get the Dasha Phal (period interpretation) narrative for the currently running Vimshottari Mahadasha + Antardasha combination — a human-readable explanation of what this dasha pair typically brings and how it interacts with the natal chart. */
546
- dashaPhal<T = unknown>(input: BirthInput & VedicMomentSettings & {
547
- date?: string;
548
- tz?: string;
607
+ /** Get the Dasha Phal (period interpretation) narrative for the Vimshottari dasha running at the given moment — Mahadasha, Antardasha and Pratyantar down to the sookshma and prana levels, plus dasha-sandhi sections when a period change is near. `birth` is the natal chart; date/time/tz are the moment to read. */
608
+ dashaPhal<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
549
609
  lang?: string;
550
610
  }, opts?: RequestOptions): Promise<T>;
551
611
  /** Get narrative interpretations for a specific dasha combination — pass mahadasha lord (and optionally antardasha lord) to get the meaning of that specific period for the natal chart. */
@@ -617,7 +677,7 @@ declare class Narrative {
617
677
  marriageOutlook<T = unknown>(input: BirthInput & VedicBirthSettings & {
618
678
  lang?: string;
619
679
  }, opts?: RequestOptions): Promise<T>;
620
- /** Get a narrative compatibility analysis for a couple — goes beyond the numeric Ashtakoota score with a written interpretation of compatibility across all factors (guna milan, mangal dosha, dashas, navamsa). */
680
+ /** Get a narrative compatibility analysis for a couple — a written reading of the Ashtakoota result (verdict and each koota; Tara and Graha Maitri are scored both ways) plus synastry sections from the graha signs of both charts. */
621
681
  milan<T = unknown>(input: {
622
682
  boyDate: string;
623
683
  boyTime: string;
@@ -653,6 +713,12 @@ declare class Narrative {
653
713
  planetsInSigns<T = unknown>(input: BirthInput & VedicBirthSettings & {
654
714
  lang?: string;
655
715
  }, opts?: RequestOptions): Promise<T>;
716
+ /** Get a Prashna (horary) narrative for the moment and place a question is asked — the Prashna lagna and Moon sections, plus the topic reading for the Prashna lagna. topic: career, financial, health, litigation, marriage, missing_person, property or travel; or questionHouse 1-12 when topic is not given (with neither, only the lagna and Moon sections). An unknown topic or a house outside 1-12 returns 400. */
717
+ prashna<T = unknown>(input: MomentInput & VedicMomentSettings & {
718
+ topic?: string;
719
+ questionHouse?: number;
720
+ lang?: string;
721
+ }, opts?: RequestOptions): Promise<T>;
656
722
  /** Get a holistic birth chart profile narrative — an executive summary of the entire chart covering lagna, Moon sign, key planetary strengths/weaknesses, dominant yogas, current dasha, and life-theme highlights in a single comprehensive reading. */
657
723
  profile<T = unknown>(input: BirthInput & VedicBirthSettings & {
658
724
  lang?: string;
@@ -667,21 +733,15 @@ declare class Narrative {
667
733
  lang?: string;
668
734
  }, opts?: RequestOptions): Promise<T>;
669
735
  /** Get a narrative of all past and future Sade Sati periods for a birth chart — written descriptions of each 7.5-year Saturn transit cycle with dates, life themes expected, and which phase (rising/peak/setting) the person experienced. */
670
- sadeSatiHistory<T = unknown>(input: BirthInput & VedicMomentSettings & {
671
- date?: string;
672
- tz?: string;
736
+ sadeSatiHistory<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
673
737
  lang?: string;
674
738
  }, opts?: RequestOptions): Promise<T>;
675
739
  /** Get a narrative interpretation of the current Sade Sati phase (rising, peak, or setting) — what the current phase typically brings and remedies. */
676
- sadeSatiPhase<T = unknown>(input: BirthInput & VedicMomentSettings & {
677
- date?: string;
678
- tz?: string;
740
+ sadeSatiPhase<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
679
741
  lang?: string;
680
742
  }, opts?: RequestOptions): Promise<T>;
681
743
  /** Get the current Sade Sati status with narrative context — whether the person is in Sade Sati, which phase, start/end dates, and a written description of the current transit's meaning for their Moon sign. */
682
- sadeSatiStatus<T = unknown>(input: BirthInput & VedicMomentSettings & {
683
- date?: string;
684
- tz?: string;
744
+ sadeSatiStatus<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
685
745
  lang?: string;
686
746
  }, opts?: RequestOptions): Promise<T>;
687
747
  /** Get a narrative interpretation of the natal Sun sign (Surya Rashi) — covers ego, identity, father, authority, vitality, and the life-purpose themes associated with the Sun's sidereal sign placement. */
@@ -698,15 +758,11 @@ declare class Narrative {
698
758
  lang?: string;
699
759
  }, opts?: RequestOptions): Promise<T>;
700
760
  /** Get a narrative of the Double Transit analysis — written explanation of which life events the current Jupiter-Saturn joint transit is activating in the chart, and when the confluence is strongest. */
701
- transitDouble<T = unknown>(input: BirthInput & VedicMomentSettings & {
702
- date?: string;
703
- tz?: string;
761
+ transitDouble<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
704
762
  lang?: string;
705
763
  }, opts?: RequestOptions): Promise<T>;
706
- /** Get the Transit Phal (gochar results) narrative — a written analysis of all current major planetary transits over the natal chart, their house positions from Moon, and the classical effects expected from each transit. */
707
- transitPhal<T = unknown>(input: BirthInput & VedicMomentSettings & {
708
- date?: string;
709
- tz?: string;
764
+ /** Get the Transit Phal (gochar results) narrative — the slow grahas (Mars, Jupiter, Saturn, Rahu, Ketu) by sign, their transit counted from the natal Moon and from the natal lagna, Sade Sati while it runs, the Sun's transit house, and Jupiter/Saturn/Rahu passing over natal grahas. `birth` is the natal chart (its lat/lon are sent as the birth place for the lagna sections); date/time/tz are the transit moment. */
765
+ transitPhal<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
710
766
  lang?: string;
711
767
  }, opts?: RequestOptions): Promise<T>;
712
768
  /** Get a narrative of the key themes for the current Varshaphal (solar-return) year — written analysis of the annual chart's varsha lord, muntha, annual lagna, and tajika yogas as a prediction for the year's major themes. */
@@ -936,6 +992,14 @@ declare class Remedies {
936
992
  id: string;
937
993
  locale?: string;
938
994
  }, opts?: RequestOptions): Promise<T>;
995
+ /** Remedies for one graha by reason (10 credits): a filter over the remedy catalogue (same rows and languages as remedies.vedic). reason: debilitated, combust, dusthana, weak_shadbala, dasha or dosha:<id> (graha is optional with dosha:<id>). Each item adds kind (mantra, daan, vrat, pooja, pilgrimage, yantra, rudraksha), weekday (0 = Sunday, or null) and matched_by. Free kinds by default; include adds pooja, pilgrimage, yantra, rudraksha; category limits to one catalogue category. */
996
+ forGraha<T = unknown>(input?: {
997
+ graha?: string;
998
+ reason?: string;
999
+ include?: string;
1000
+ category?: string;
1001
+ lang?: string;
1002
+ }, opts?: RequestOptions): Promise<T>;
939
1003
  /** Lal Kitab remedies for a specific planet-in-house placement (e.g. saturn in house 8). */
940
1004
  lalkitabForPlacement<T = unknown>(input: {
941
1005
  planet: string;
@@ -1094,18 +1158,24 @@ declare class Transit {
1094
1158
  positions<T = unknown>(input?: InstantInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1095
1159
  /** Saturn Sade Sati status (rising/peak/setting) relative to the birth Moon. */
1096
1160
  sadeSati<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1097
- /** Check whether a person is currently in Small Panoti (Ashtama Shani) — the 2.5-year Saturn transit through the 8th house from natal Moon, considered challenging. */
1098
- smallPanoti<T = unknown>(input: BirthInput & VedicMomentSettings & {
1099
- date?: string;
1100
- time?: string;
1101
- tz?: string;
1161
+ /** Sade Sati and Dhaiya windows from the natal Moon (20 credits): intervals (one per stay of Saturn in a sign, kind sade_sati with phase rising/peak/setting, dhaiya_4 kantak or dhaiya_8 ashtama, exact ingress times, retro_reentry), cycles (merged passes with phase spans) and at_from (status at from). from defaults to now, years 25 (max 60); includePast starts at birth. Every instant comes as *_local (RFC 3339 with offset) and *_jd (Julian Day, UT); fields that cannot be computed are listed in skipped. */
1162
+ sadeSatiWindows<T = unknown>(input: NatalWindowInput & VedicMomentSettings & {
1163
+ years?: number;
1164
+ includePast?: boolean;
1102
1165
  }, opts?: RequestOptions): Promise<T>;
1166
+ /** Check whether a person is currently in Small Panoti (Ashtama Shani) — the 2.5-year Saturn transit through the 8th house from natal Moon, considered challenging. */
1167
+ smallPanoti<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1103
1168
  /** Get the complete history and future windows of Small Panoti (Ashtama Shani) for a natal chart — all past and upcoming 2.5-year periods when Saturn transits the 8th house from natal Moon. */
1104
1169
  smallPanotiHistory<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1105
1170
  /** Compute Tara Bala for today's transiting Moon relative to a natal chart — rates the day as Janma/Sampat/Vipat/Kshema/Pratyak/Sadhana/Vadha/Mitra/Param-Mitra tara. */
1106
1171
  tarabala<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1107
1172
  /** Check Vedha (transit obstruction) for a natal chart — certain house transits are blocked (vedha'd) by another planet transiting a specific opposing house simultaneously. */
1108
1173
  vedha<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1174
+ /** Every stay of one planet (sun..ketu) in a sidereal sign that overlaps [from, from + years] (20 credits), with exact ingress times, retro_reentry and retrograde_at_start. With birth (date, time, tz) each window has house_from_moon; with birth lat/lon also house_from_lagna. years: default 25 / max 60 for jupiter, saturn, rahu, ketu; 5 / 20 for sun, mercury, venus, mars; 1 / 2 for moon. Every instant comes as *_local (RFC 3339 with offset) and *_jd (Julian Day, UT); fields that cannot be computed are listed in skipped. */
1175
+ windows<T = unknown>(input: OptionalNatalWindowInput & VedicMomentSettings & {
1176
+ planet: string;
1177
+ years?: number;
1178
+ }, opts?: RequestOptions): Promise<T>;
1109
1179
  }
1110
1180
 
1111
1181
  declare class Varshaphal {
@@ -1119,7 +1189,7 @@ declare class Varshaphal {
1119
1189
  harshaBala<T = unknown>(input: BirthInput & VedicBirthSettings & {
1120
1190
  year: number;
1121
1191
  }, opts?: RequestOptions): Promise<T>;
1122
- /** Get the Varsha Lord (year ruler) for an annual chart — the planet that rules the Varshaphal year based on the Tajika system. */
1192
+ /** Get the Varsha Lord (Varshesha, year ruler) for an annual chart, chosen by the Tajika Panchadhikari rule from the five office-bearers (Munthesh, Janmesh, Varsha Lagnesh, Trirashipati, Dina/Ratripati); the response also lists the candidates and the hora lord of the return. */
1123
1193
  lord<T = unknown>(input: BirthInput & VedicBirthSettings & {
1124
1194
  year: number;
1125
1195
  }, opts?: RequestOptions): Promise<T>;
@@ -1773,4 +1843,4 @@ declare class LifeAstroConnectionError extends LifeAstroError {
1773
1843
  * @packageDocumentation
1774
1844
  */
1775
1845
 
1776
- export { type ApiErrorBody, AuthenticationError, type Ayanamsa, BadRequestError, type BirthInput, type BoyGirlInput, type ClientCore, type DateRangeInput, type FetchLike, type HouseSystem, LifeAstro, LifeAstroConnectionError, LifeAstroError, type LifeAstroOptions, type Locale, type MomentInput, type MuhurtaInput, type NatalTransitInput, NotFoundError, type NumerologyInput, PaymentRequiredError, PermissionError, type QueryParams, type QueryValue, type RashiInput, RateLimitError, type RequestOptions, type ResponseEnvelope, type ResponseMeta, ServerError, type TwoPersonInput, VERSION, type VedicBirthSettings, type VedicMomentSettings, type WesternMomentInput, type WesternNatalInput, LifeAstro as default };
1846
+ export { type ApiErrorBody, AuthenticationError, type Ayanamsa, BadRequestError, type BirthInput, type BoyGirlInput, type ClientCore, type DateRangeInput, type FetchLike, type HouseSystem, LifeAstro, LifeAstroConnectionError, LifeAstroError, type LifeAstroOptions, type Locale, type MomentInput, type MuhurtaInput, type NatalTransitInput, type NatalWindowBirth, type NatalWindowInput, NotFoundError, type NumerologyInput, type OptionalNatalWindowInput, PaymentRequiredError, PermissionError, type QueryParams, type QueryValue, type RashiInput, RateLimitError, type RequestOptions, type ResponseEnvelope, type ResponseMeta, ServerError, type TwoPersonInput, VERSION, type VedicBirthSettings, type VedicMomentSettings, type WesternMomentInput, type WesternNatalInput, LifeAstro as default };