lifeastroapi 0.0.0-stage → 0.4.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.
@@ -0,0 +1,1776 @@
1
+ /**
2
+ * Shared request/response types for the LifeAstroAPI SDK.
3
+ *
4
+ * Response payloads (`data`) are intentionally typed as `unknown` at the SDK
5
+ * boundary: the API surfaces ~270 distinct response shapes and they evolve
6
+ * independently of this client. Pass a type parameter to any call to narrow
7
+ * it yourself, e.g. `client.chart.planets<MyPlanetsShape>(birth)`.
8
+ */
9
+ /** Diagnostic metadata of a `{ data, meta }` envelope, when one is present. */
10
+ interface ResponseMeta {
11
+ request_id?: string;
12
+ computed_at?: string;
13
+ cache?: "hit" | "miss" | (string & {});
14
+ tier?: string;
15
+ [key: string]: unknown;
16
+ }
17
+ /**
18
+ * An optional `{ data, meta }` wrapper. The API returns the payload directly
19
+ * (bare JSON); the SDK unwraps this envelope only if a response carries one.
20
+ */
21
+ interface ResponseEnvelope<T = unknown> {
22
+ data: T;
23
+ meta?: ResponseMeta;
24
+ }
25
+ /** Sidereal ayanamsha systems supported by the API. */
26
+ type Ayanamsa = "lahiri" | "krishnamurti" | "raman" | "fagan" | "yukteshwar" | "true_chitrapaksha";
27
+ /** House systems supported by the API. */
28
+ type HouseSystem = "whole-sign" | "equal" | "placidus" | "koch" | "porphyry" | "campanus" | "regiomontanus";
29
+ /** Narrative / horoscope response languages. */
30
+ type Locale = "en" | "hi" | "mr" | "bn" | "kn" | "ta" | "te" | "gu";
31
+ /**
32
+ * A birth (or event) moment with a fixed location. `date`/`time`/`tz` describe
33
+ * the civil moment; `lat`/`lon` the observer.
34
+ */
35
+ interface BirthInput {
36
+ /** ISO date, `YYYY-MM-DD`. */
37
+ date: string;
38
+ /** 24-hour time, `HH:MM`. */
39
+ time: string;
40
+ /** IANA name (`Asia/Kolkata`) or fixed offset (`+05:30`). */
41
+ tz: string;
42
+ /** Latitude in decimal degrees, north positive. */
43
+ lat: number;
44
+ /** Longitude in decimal degrees, east positive. */
45
+ lon: number;
46
+ }
47
+ /**
48
+ * A moment + location for panchang-style queries. `date` is optional: the API
49
+ * itself requires one, so the SDK sends today's date in `tz` when you omit it.
50
+ */
51
+ interface MomentInput {
52
+ /** Latitude in decimal degrees, north positive. */
53
+ lat: number;
54
+ /** Longitude in decimal degrees, east positive. */
55
+ lon: number;
56
+ /** IANA name (`Asia/Kolkata`) or fixed offset (`+05:30`). */
57
+ tz: string;
58
+ /** ISO date, `YYYY-MM-DD`. Defaults to today in `tz`. */
59
+ date?: string;
60
+ /** 24-hour time, `HH:MM`. */
61
+ time?: string;
62
+ }
63
+ /**
64
+ * A moment with no location (planet positions, ayanamsa values). Everything is
65
+ * optional: the SDK sends today's date and `UTC` when omitted.
66
+ */
67
+ interface InstantInput {
68
+ /** ISO date, `YYYY-MM-DD`. Defaults to today in `tz`. */
69
+ date?: string;
70
+ /** 24-hour time, `HH:MM`. The API uses 12:00 when omitted. */
71
+ time?: string;
72
+ /** IANA name (`Asia/Kolkata`) or fixed offset (`+05:30`). Defaults to `UTC`. */
73
+ tz?: string;
74
+ }
75
+ /** Calculation settings accepted by most Vedic moment endpoints. */
76
+ interface VedicMomentSettings {
77
+ ayanamsa?: Ayanamsa;
78
+ }
79
+ /** Calculation settings accepted by most Vedic birth-chart endpoints. */
80
+ interface VedicBirthSettings {
81
+ ayanamsa?: Ayanamsa;
82
+ houseSystem?: HouseSystem;
83
+ }
84
+ /** Two birth charts for Vedic matchmaking (`boy` = groom, `girl` = bride). */
85
+ interface BoyGirlInput {
86
+ boy: BirthInput;
87
+ girl: BirthInput;
88
+ }
89
+ /** Two birth charts for Western synastry / composite work. */
90
+ interface TwoPersonInput {
91
+ personA: BirthInput;
92
+ personB: BirthInput;
93
+ }
94
+ /** Horoscope-by-sign input. `rashi` is case-insensitive (English or Hindi). */
95
+ interface RashiInput {
96
+ rashi: string;
97
+ date?: string;
98
+ lang?: Locale;
99
+ }
100
+ /** Numerology input. Provide `name` and/or `dob` depending on the number. */
101
+ interface NumerologyInput {
102
+ /** Full name as written on official documents. */
103
+ name?: string;
104
+ /** Date of birth, `YYYY-MM-DD`. */
105
+ dob?: string;
106
+ lang?: Locale;
107
+ }
108
+ /** A `[startDate, endDate]` window (`YYYY-MM-DD`). */
109
+ interface DateRangeInput {
110
+ startDate: string;
111
+ endDate: string;
112
+ }
113
+ /** A Western natal chart input (tropical). */
114
+ interface WesternNatalInput extends BirthInput {
115
+ houseSystem?: HouseSystem;
116
+ }
117
+ /** A Western transit moment (no location needed). */
118
+ interface WesternMomentInput {
119
+ date: string;
120
+ time: string;
121
+ tz: string;
122
+ }
123
+ /** A muhurta search: a location plus a `[startDate, endDate]` window. */
124
+ interface MuhurtaInput {
125
+ lat: number;
126
+ lon: number;
127
+ tz: string;
128
+ startDate: string;
129
+ endDate: string;
130
+ }
131
+ /**
132
+ * A natal chart plus a separate transit moment — used by transits-to-natal
133
+ * style endpoints. `birth` is the natal data; `date`/`time`/`tz` describe the
134
+ * moment whose transits are evaluated against it.
135
+ */
136
+ interface NatalTransitInput {
137
+ birth: BirthInput;
138
+ /** Transit date, `YYYY-MM-DD`. */
139
+ date: string;
140
+ /** Transit time, `HH:MM`. */
141
+ time: string;
142
+ /** Transit timezone (IANA or fixed offset). */
143
+ tz: string;
144
+ }
145
+ /** Low-level query value. */
146
+ type QueryValue = string | number | boolean | null | undefined;
147
+ type QueryParams = Record<string, QueryValue>;
148
+
149
+ type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
150
+ interface RequestOptions {
151
+ /** Per-call abort signal (in addition to the timeout). */
152
+ signal?: AbortSignal;
153
+ /** Override the client timeout for this call. */
154
+ timeoutMs?: number;
155
+ /** Return the response body exactly as received, without unwrapping a `{ data, meta }` envelope if one is present. */
156
+ raw?: boolean;
157
+ }
158
+
159
+ declare class Ashtakavarga {
160
+ private readonly _c;
161
+ constructor(_c: ClientCore);
162
+ /** Bhinnashtakavarga (BAV) for one planet. */
163
+ bhinna<T = unknown>(input: BirthInput & VedicMomentSettings & {
164
+ planet: string;
165
+ }, opts?: RequestOptions): Promise<T>;
166
+ /** 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>;
171
+ /** Get the Sarvashtakavarga table — the combined 12-sign benefic-point grid from all 9 grahas. */
172
+ sarva<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
173
+ /** 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>;
178
+ }
179
+
180
+ declare class Calendar {
181
+ private readonly _c;
182
+ constructor(_c: ClientCore);
183
+ /** 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. */
184
+ adhikMaas<T = unknown>(input: {
185
+ year: number;
186
+ tz?: string;
187
+ }, opts?: RequestOptions): Promise<T>;
188
+ /** 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. */
189
+ month<T = unknown>(input: {
190
+ date: string;
191
+ tz: string;
192
+ }, opts?: RequestOptions): Promise<T>;
193
+ /** 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). */
194
+ ritu<T = unknown>(input: {
195
+ date: string;
196
+ tz: string;
197
+ }, opts?: RequestOptions): Promise<T>;
198
+ /** Get the Samvatsara (Jupiter year) name for a given year — the 60-year Jupiter cycle used in Hindu astrology (Prabhava, Vibhava, Shukla, … Akshaya). */
199
+ samvatsara<T = unknown>(input: {
200
+ date: string;
201
+ tz: string;
202
+ }, opts?: RequestOptions): Promise<T>;
203
+ /** 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. */
204
+ solstices<T = unknown>(input: {
205
+ year: number;
206
+ tz?: string;
207
+ lat?: number;
208
+ lon?: number;
209
+ alt?: number;
210
+ }, opts?: RequestOptions): Promise<T>;
211
+ }
212
+
213
+ declare class Chart {
214
+ private readonly _c;
215
+ constructor(_c: ClientCore);
216
+ /** Ascendant (Lagna): sign, degree, nakshatra, pada and lord. */
217
+ ascendant<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
218
+ /** Sarvashtakavarga (SAV) grid; grand total is always 337. */
219
+ ashtakvarga<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
220
+ /** One planet's Bhinnashtakavarga row: its benefic points (bindus) in each of the 12 signs. `planet` is Sun, Moon, Mars, Mercury, Jupiter, Venus or Saturn. */
221
+ ashtakvargaPlanet<T = unknown>(input: BirthInput & VedicBirthSettings & {
222
+ planet: string;
223
+ }, opts?: RequestOptions): Promise<T>;
224
+ /** Vedic graha drishti (planetary aspects) table. */
225
+ aspects<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
226
+ /** Full birth-chart snapshot: avakhada, ascendant, all planets, sun/moon sign and birth panchang. */
227
+ astroDetails<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
228
+ /** Avakhada Chakra: varna, vashya, yoni, gana, nadi and lucky factors. */
229
+ avakhada<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
230
+ /** Compute Bhava Bala — the six-component strength of each of the 12 houses: Bhavadhipati Bala (lord strength), Bhava Digbala, Bhava Drishti Bala, and more. */
231
+ bhavabala<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
232
+ /** Check which planets are combust (too close to the Sun) in a birth chart — returns each planet's angular distance from Sun, whether it is combust by classical limits, and combust severity. */
233
+ combustion<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
234
+ /** Every planet's dignity (exalted/debilitated/own/friend/enemy/neutral). */
235
+ dignity<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
236
+ /** Any divisional (varga) chart, e.g. D1, D9, D10, D60. */
237
+ divisional<T = unknown>(input: BirthInput & VedicBirthSettings & {
238
+ varga: string;
239
+ }, opts?: RequestOptions): Promise<T>;
240
+ /** Ghatak Chakra (inauspicious indicators) for the chart. */
241
+ ghatak<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
242
+ /** Identify Graha Yuddha (planetary war) in a birth chart — occurs when two visible planets are within 1° of each other. */
243
+ grahaYuddha<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
244
+ /** List all planets occupying each of the 12 houses in a birth chart — a house-indexed view of the chart (vs planet-indexed from chart_planets). */
245
+ houseOccupants<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
246
+ /** 12 house cusps / occupants for the chosen house system. */
247
+ houses<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
248
+ /** Get KP (Krishnamurti Paddhati) house significators for a given cusp — lists planets that significate the house through occupancy, lordship, and sub-lord chain. */
249
+ kpHouseSignificator<T = unknown>(input: BirthInput & VedicBirthSettings & {
250
+ cusp: number;
251
+ }, opts?: RequestOptions): Promise<T>;
252
+ /** Get the KP sublord of a planet — the sub-lord of the nakshatra sub-division the planet occupies (KP star lord → sub lord → sub-sub lord chain). */
253
+ kpSublord<T = unknown>(input: BirthInput & VedicBirthSettings & {
254
+ planet: string;
255
+ }, opts?: RequestOptions): Promise<T>;
256
+ /** Birth (Janma) nakshatra and pada. */
257
+ nakshatra<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
258
+ /** Navamsa (D9) divisional chart — convenience alias for divisional('D9'). */
259
+ navamsa<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
260
+ /** Detail for a single planet (sun|moon|mars|mercury|jupiter|venus|saturn|rahu|ketu). */
261
+ planet<T = unknown>(input: BirthInput & VedicBirthSettings & {
262
+ name: string;
263
+ }, opts?: RequestOptions): Promise<T>;
264
+ /** All 9 grahas with sign, degree, nakshatra, house, retrograde, dignity, combustion and speed. */
265
+ planets<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
266
+ /** Shadbala (six-fold strength) for all 7 planets with components. */
267
+ shadbala<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
268
+ /** One shadbala component (sthana|dig|kala|chesta|naisargika|drik) for all planets. */
269
+ shadbalaComponent<T = unknown>(input: BirthInput & VedicBirthSettings & {
270
+ component: string;
271
+ }, opts?: RequestOptions): Promise<T>;
272
+ }
273
+
274
+ declare class Dasha {
275
+ private readonly _c;
276
+ constructor(_c: ClientCore);
277
+ /** Full Char Dasha (Jaimini sign-based dasha) schedule — every mahadasha sign period with start/end dates. */
278
+ char<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
279
+ /** Sub-periods inside a Char Dasha mahadasha+antardasha sign pair. */
280
+ charAntar<T = unknown>(input: BirthInput & VedicBirthSettings & {
281
+ md: string;
282
+ ad: string;
283
+ }, opts?: RequestOptions): Promise<T>;
284
+ /** Currently running Char Dasha (Jaimini) period stack — active mahadasha and antardasha signs with date windows. */
285
+ charCurrent<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
286
+ /** Antardashas inside one Char Dasha mahadasha sign (md = sign name, e.g. 'leo'). */
287
+ charMaha<T = unknown>(input: BirthInput & VedicBirthSettings & {
288
+ md: string;
289
+ }, opts?: RequestOptions): Promise<T>;
290
+ /** Char Dasha mahadasha-level periods only — one row per sign period. */
291
+ charMajor<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
292
+ /** Full Vimshottari dasha tree (depth 1-5). */
293
+ vimshottari<T = unknown>(input: BirthInput & VedicBirthSettings & {
294
+ depth?: number;
295
+ }, opts?: RequestOptions): Promise<T>;
296
+ /** Pratyantardashas within a Maha+Antar pair. */
297
+ vimshottariAntar<T = unknown>(input: BirthInput & VedicBirthSettings & {
298
+ md: string;
299
+ ad: string;
300
+ }, opts?: RequestOptions): Promise<T>;
301
+ /** Currently running 5-level Vimshottari dasha stack (optionally at a custom moment). */
302
+ vimshottariCurrent<T = unknown>(input: BirthInput & VedicBirthSettings & {
303
+ at?: string;
304
+ }, opts?: RequestOptions): Promise<T>;
305
+ /** Antardashas within one Mahadasha lord. */
306
+ vimshottariMaha<T = unknown>(input: BirthInput & VedicBirthSettings & {
307
+ md: string;
308
+ }, opts?: RequestOptions): Promise<T>;
309
+ /** Sookshma periods within a 3-level Vimshottari combination. */
310
+ vimshottariPratyantar<T = unknown>(input: BirthInput & VedicBirthSettings & {
311
+ md: string;
312
+ ad: string;
313
+ pd: string;
314
+ }, opts?: RequestOptions): Promise<T>;
315
+ /** Prana periods within a 4-level Vimshottari combination. */
316
+ vimshottariSookshma<T = unknown>(input: BirthInput & VedicBirthSettings & {
317
+ md: string;
318
+ ad: string;
319
+ pd: string;
320
+ sd: string;
321
+ }, opts?: RequestOptions): Promise<T>;
322
+ /** Full Yogini dasha tree (36-year cycle, 8 lords). */
323
+ yogini<T = unknown>(input: BirthInput & VedicBirthSettings & {
324
+ depth?: number;
325
+ }, opts?: RequestOptions): Promise<T>;
326
+ /** Yogini dasha sub-periods for a named Yogini lord. */
327
+ yoginiByName<T = unknown>(input: BirthInput & VedicBirthSettings & {
328
+ name: string;
329
+ }, opts?: RequestOptions): Promise<T>;
330
+ /** Currently running Yogini dasha. */
331
+ yoginiCurrent<T = unknown>(input: BirthInput & VedicBirthSettings & {
332
+ at?: string;
333
+ }, opts?: RequestOptions): Promise<T>;
334
+ }
335
+
336
+ declare class Eclipses {
337
+ private readonly _c;
338
+ constructor(_c: ClientCore);
339
+ /** All eclipses (solar + lunar) in a date range. With lat/lon (and tz) each event carries a `local` block: contact times sparsha…moksha in local time, visibility at that place, and the sutak kaal (12 h before a solar, 9 h before a lunar eclipse, until moksha). */
340
+ all<T = unknown>(input: DateRangeInput & {
341
+ lat?: number;
342
+ lon?: number;
343
+ alt?: number;
344
+ tz?: string;
345
+ }, opts?: RequestOptions): Promise<T>;
346
+ /** Lunar eclipses in a date range. With lat/lon (and tz) each event carries a `local` block: contact times sparsha…moksha in local time, visibility at that place, and the sutak kaal (12 h before a solar, 9 h before a lunar eclipse, until moksha). */
347
+ lunar<T = unknown>(input: DateRangeInput & {
348
+ lat?: number;
349
+ lon?: number;
350
+ alt?: number;
351
+ tz?: string;
352
+ }, opts?: RequestOptions): Promise<T>;
353
+ /** Solar eclipses in a date range. With lat/lon (and tz) each event carries a `local` block: contact times sparsha…moksha in local time, visibility at that place, and the sutak kaal (12 h before a solar, 9 h before a lunar eclipse, until moksha). */
354
+ solar<T = unknown>(input: DateRangeInput & {
355
+ lat?: number;
356
+ lon?: number;
357
+ alt?: number;
358
+ tz?: string;
359
+ }, opts?: RequestOptions): Promise<T>;
360
+ }
361
+
362
+ declare class Festivals {
363
+ private readonly _c;
364
+ constructor(_c: ClientCore);
365
+ /** Full Hindu festival calendar for a month at a location: every Ekadashi (smarta + Vaishnava/Gauna with parana window), Pradosh, Sankashti/Vinayaka Chaturthi, Purnima/Amavasya, Chandra Darshana, Sankrantis, major and regional festivals, jayantis, national days and eclipses. Location-aware (defaults to New Delhi / Asia/Kolkata); verified entry for entry against printed panchang calendars of 14 cities. */
366
+ month<T = unknown>(input: {
367
+ year: number;
368
+ month: number;
369
+ lat?: number;
370
+ lon?: number;
371
+ tz?: string;
372
+ locale?: string;
373
+ monthSystem?: string;
374
+ ayanamsa?: string;
375
+ }, opts?: RequestOptions): Promise<T>;
376
+ /** All festivals, vrats and observances on one civil date at a location (same engine and fields as festivals.month): Ekadashi smarta/Vaishnava, Pradosh, Purnima, Amavasya, Sankranti, jayantis, eclipses, each with the windows a panchang prints (moonrise, pradosh kaal, parana). Defaults to New Delhi / Asia/Kolkata. */
377
+ onDate<T = unknown>(input: {
378
+ date: string;
379
+ lat?: number;
380
+ lon?: number;
381
+ tz?: string;
382
+ locale?: string;
383
+ monthSystem?: string;
384
+ ayanamsa?: string;
385
+ }, opts?: RequestOptions): Promise<T>;
386
+ /** Year-wise Vrat & Upavas dates of one family at a location — type: ekadashi | parana | pradosh | sankashti | vinayaka | purnima | amavasya | chandra_darshana | masik_shivaratri | durgashtami | kalashtami | skanda_shashthi | karthigai | shraddha | janmashtami | sankranti | satyanarayana | bhanu_saptami | eclipse (comma-separated for several). Same occurrence objects as festivals.month. */
387
+ vrat<T = unknown>(input: {
388
+ year: number;
389
+ type: string;
390
+ lat?: number;
391
+ lon?: number;
392
+ tz?: string;
393
+ locale?: string;
394
+ monthSystem?: string;
395
+ ayanamsa?: string;
396
+ }, opts?: RequestOptions): Promise<T>;
397
+ }
398
+
399
+ declare class Geo {
400
+ private readonly _c;
401
+ constructor(_c: ClientCore);
402
+ /** Full details for a place by its geo id. */
403
+ place<T = unknown>(input: {
404
+ id: string;
405
+ }, opts?: RequestOptions): Promise<T>;
406
+ /** Reverse geocode coordinates to the nearest place (free). */
407
+ reverse<T = unknown>(input: {
408
+ lat: number;
409
+ lon: number;
410
+ limit?: number;
411
+ }, opts?: RequestOptions): Promise<T>;
412
+ /** Search for a city or place by name — returns matching locations with latitude, longitude, state/province, country, and IANA timezone. */
413
+ search<T = unknown>(input: {
414
+ q: string;
415
+ limit?: number;
416
+ cc?: string;
417
+ }, opts?: RequestOptions): Promise<T>;
418
+ /** Get the IANA timezone for a latitude/longitude — returns timezone name (e.g. */
419
+ timezone<T = unknown>(input: {
420
+ lat: number;
421
+ lon: number;
422
+ }, opts?: RequestOptions): Promise<T>;
423
+ }
424
+
425
+ declare class Horoscope {
426
+ private readonly _c;
427
+ constructor(_c: ClientCore);
428
+ /** Daily horoscope by Moon sign (rashi). */
429
+ daily<T = unknown>(input: RashiInput, opts?: RequestOptions): Promise<T>;
430
+ /** Monthly horoscope by rashi. */
431
+ monthly<T = unknown>(input: RashiInput & {
432
+ month: string;
433
+ }, opts?: RequestOptions): Promise<T>;
434
+ /** Weekly horoscope by rashi. */
435
+ weekly<T = unknown>(input: RashiInput & {
436
+ week: string;
437
+ }, opts?: RequestOptions): Promise<T>;
438
+ }
439
+
440
+ declare class Lalkitab {
441
+ private readonly _c;
442
+ constructor(_c: ClientCore);
443
+ /** Lal Kitab chart — planets mapped into Lal Kitab's fixed Aries-based houses. */
444
+ chart<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
445
+ /** Full 35-year Lal Kitab dasha schedule — planet-ruled periods with start/end dates. */
446
+ dasha<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
447
+ /** Currently active Lal Kitab dasha planet and period window. */
448
+ dashaCurrent<T = unknown>(input: BirthInput & VedicBirthSettings, opts?: RequestOptions): Promise<T>;
449
+ }
450
+
451
+ declare class Meta {
452
+ private readonly _c;
453
+ constructor(_c: ClientCore);
454
+ /** The supported ayanamsa systems with each one's value in degrees on a date (defaults to today). Free (0 credits). */
455
+ ayanamsas<T = unknown>(input?: InstantInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
456
+ /** Every API route with its credit cost and group. Free (0 credits). */
457
+ endpoints<T = unknown>(input?: Record<string, never>, opts?: RequestOptions): Promise<T>;
458
+ /** Catalog of every dosha the API detects and narrates, with the IDs `narrative.dosha` accepts. Free (0 credits). */
459
+ vedicDoshas<T = unknown>(input?: Record<string, never>, opts?: RequestOptions): Promise<T>;
460
+ /** The languages narrative endpoints can answer in, with corpus coverage for each. Free (0 credits). */
461
+ vedicLocales<T = unknown>(input?: Record<string, never>, opts?: RequestOptions): Promise<T>;
462
+ /** The axes narrative text can vary along (locale, regional pack). Free (0 credits). */
463
+ vedicNarrativeAxes<T = unknown>(input?: Record<string, never>, opts?: RequestOptions): Promise<T>;
464
+ /** Catalog of every yoga the API detects and narrates, with the IDs `narrative.yoga` accepts. Free (0 credits). */
465
+ vedicYogas<T = unknown>(input?: Record<string, never>, opts?: RequestOptions): Promise<T>;
466
+ /** API build and ephemeris version. Free (0 credits). */
467
+ version<T = unknown>(input?: Record<string, never>, opts?: RequestOptions): Promise<T>;
468
+ }
469
+
470
+ declare class Milan {
471
+ private readonly _c;
472
+ constructor(_c: ClientCore);
473
+ /** Full 36-point Ashtakoota breakdown across all 8 kootas. */
474
+ ashtakoota<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
475
+ /** One koota (varna|vashya|tara|yoni|graha_maitri|gana|bhakoot|nadi). */
476
+ ashtakootaKoota<T = unknown>(input: BoyGirlInput & VedicMomentSettings & {
477
+ koota: string;
478
+ }, opts?: RequestOptions): Promise<T>;
479
+ /** Just the Ashtakoota (Guna Milan) total score and verdict. */
480
+ 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>;
483
+ /** Check Dhan Yog (wealth yoga) for a single person's chart — assesses 2nd/11th house lord strength and Jupiter placement for prosperity. */
484
+ dhanYog<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
485
+ /** Assess longevity for a single person's chart — classical analysis of lagna, 8th house, and Moon sign longevity indicators. */
486
+ longevity<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
487
+ /** Check Mahendra Koota — the 4th additional compatibility factor beyond Ashtakoota. */
488
+ mahendra<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
489
+ /** Mangal Dosha (Manglik) detection for one chart. */
490
+ mangalDosha<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
491
+ /** Nadi dosha detection plus exceptions. */
492
+ nadiDosha<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
493
+ /** Check Navamsa compatibility — compares the D9 (Navamsa) chart placements of both partners for deeper marriage harmony beyond the D1 chart. */
494
+ navamsaCompat<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
495
+ /** Check Santan Yog for a single person's chart — assesses 5th house lord and Jupiter placement to indicate prospects for children. */
496
+ santanYog<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
497
+ /** Check Shani Dosha for a single person's chart — Saturn in 1st, 4th, 7th, 10th, or 12th house from lagna. */
498
+ shaniDosha<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
499
+ /** 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
+ streeDirgha<T = unknown>(input: BoyGirlInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
501
+ /** Vivah Phal (marriage-outcome) assessment for one chart. */
502
+ vivahPhal<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
503
+ }
504
+
505
+ declare class Muhurta {
506
+ private readonly _c;
507
+ constructor(_c: ClientCore);
508
+ /** Best-scoring general muhurta window in a date range. */
509
+ bestTime<T = unknown>(input: MuhurtaInput, opts?: RequestOptions): Promise<T>;
510
+ /** Compute Chandra Bala — the Moon's strength relative to a person's natal Moon sign on a given date. */
511
+ chandraBala<T = unknown>(input: BirthInput & VedicBirthSettings & {
512
+ birthMoonSign: number;
513
+ }, opts?: RequestOptions): Promise<T>;
514
+ /** Find auspicious Griha Pravesh (housewarming) muhurta windows in a date range — checks tithi, nakshatra, vara, Sun position, and lagna for the ceremony. */
515
+ grahaPravesh<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
516
+ /** Naamkaran (naming ceremony) muhurta windows. */
517
+ naamkaran<T = unknown>(input: MomentInput & VedicMomentSettings & {
518
+ birthDate: string;
519
+ }, opts?: RequestOptions): Promise<T>;
520
+ /** Find Panchaka-free (Panchaka Rahita) windows in a date range — Panchaka occurs when Moon is in Aquarius or Pisces and creates obstacles for travel, construction, funerals, and certain ceremonies. */
521
+ panchakaRahita<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
522
+ /** Find Sarvartha Siddhi Yoga windows — one of the most auspicious panchang yogas formed by specific vara+nakshatra combinations. */
523
+ sarvarthaSiddhi<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
524
+ /** Find Shubha Yoga (auspicious panchang yoga) windows in a date range — checks for Amrit Siddhi, Sarvartha Siddhi, Ravi Yoga, and other classical panchang yogas in combination. */
525
+ shubhaYoga<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
526
+ /** Compute Tara Bala score for a given date relative to a person's birth nakshatra — rates the day's Moon nakshatra as Janma/Sampat/Vipat/Kshema/Pratyak/Sadhana/Vadha/Mitra/Param-Mitra. */
527
+ taraBala<T = unknown>(input: BirthInput & VedicBirthSettings & {
528
+ birthNak: number;
529
+ }, opts?: RequestOptions): Promise<T>;
530
+ /** Auspicious wedding (vivah) muhurta windows in a date range. */
531
+ vivah<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
532
+ /** Find auspicious Vyapar (business/trade) muhurta windows — suitable for starting a business, signing contracts, launching a product, or opening a shop. */
533
+ vyapar<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
534
+ /** Find auspicious Yatra (travel/journey) muhurta windows — avoids Disha Shool (directional inauspiciousness), Rahu Kaal, Nak Shool, and favours Pushya/Hasta/Ashwini/Anuradha nakshatras for journeys. */
535
+ yatra<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
536
+ }
537
+
538
+ declare class Narrative {
539
+ private readonly _c;
540
+ constructor(_c: ClientCore);
541
+ /** Get a multi-paragraph career and profession narrative for a Vedic birth chart — analyses the 10th house lord, planets in the 10th, D10 chart, and dashas to describe career strengths, suitable professions, and current period's impact on work. */
542
+ careerOutlook<T = unknown>(input: BirthInput & VedicBirthSettings & {
543
+ lang?: string;
544
+ }, 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;
549
+ lang?: string;
550
+ }, opts?: RequestOptions): Promise<T>;
551
+ /** 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. */
552
+ dashaTreePhal<T = unknown>(input: BirthInput & VedicMomentSettings & {
553
+ maha: string;
554
+ antar?: string;
555
+ lang?: string;
556
+ }, opts?: RequestOptions): Promise<T>;
557
+ /** Narrative interpretation of a divisional (varga) chart. */
558
+ divisional<T = unknown>(input: BirthInput & VedicBirthSettings & {
559
+ varga: string;
560
+ lang?: string;
561
+ }, opts?: RequestOptions): Promise<T>;
562
+ /** Narrative interpretation of a specific dosha in the chart. */
563
+ dosha<T = unknown>(input: BirthInput & VedicBirthSettings & {
564
+ id: string;
565
+ lang?: string;
566
+ }, opts?: RequestOptions): Promise<T>;
567
+ /** Get the Doshas narrative for a birth chart — comprehensive analysis of all major afflictions (Mangal Dosha, Kaal Sarp Dosha, Pitru Dosha, Shrapit Dosha, Guru Chandal Yoga, Grahan Yoga) with presence, severity, cancellations, and remedial guidance. */
568
+ doshas<T = unknown>(input: BirthInput & VedicBirthSettings & {
569
+ lang?: string;
570
+ }, opts?: RequestOptions): Promise<T>;
571
+ /** Get a finance and wealth narrative for a Vedic birth chart — analyses the 2nd and 11th house lords, Jupiter, Venus, and wealth yogas to describe financial strengths, challenges, and periods of prosperity. */
572
+ financeOutlook<T = unknown>(input: BirthInput & VedicBirthSettings & {
573
+ lang?: string;
574
+ }, opts?: RequestOptions): Promise<T>;
575
+ /** Get a personalised daily horoscope narrative computed from the rising sign (lagna) of a birth chart — more precise than generic Moon-sign horoscopes since it uses the exact birth data. The input is the birth chart; pass `onDate` (YYYY-MM-DD) to read a day other than today. */
576
+ horoscopeDailyByLagna<T = unknown>(input: BirthInput & VedicBirthSettings & {
577
+ onDate?: string;
578
+ lang?: string;
579
+ }, opts?: RequestOptions): Promise<T>;
580
+ /** Get a personalised daily horoscope narrative computed from the natal Moon sign with full transit context — richer than a generic rashifal because it uses the birth chart's Moon degree and current transit aspects. The input is the birth chart; pass `onDate` (YYYY-MM-DD) to read a day other than today. */
581
+ horoscopeDailyByMoon<T = unknown>(input: BirthInput & VedicBirthSettings & {
582
+ onDate?: string;
583
+ lang?: string;
584
+ }, opts?: RequestOptions): Promise<T>;
585
+ /** Get a daily horoscope in Tamil astrology style — uses the Tamil rashi system and traditional Tamil Panchangam for the day's reading. The input is the birth chart; pass `onDate` (YYYY-MM-DD) to read a day other than today. */
586
+ horoscopeDailyTamil<T = unknown>(input: BirthInput & VedicBirthSettings & {
587
+ onDate?: string;
588
+ }, opts?: RequestOptions): Promise<T>;
589
+ /** Get a personalised weekly horoscope narrative computed from the birth chart's rising sign (lagna) — personalised 7-day outlook with major transit themes. The input is the birth chart; pass `onDate` (YYYY-MM-DD) to read a day other than today. */
590
+ horoscopeWeeklyByLagna<T = unknown>(input: BirthInput & VedicBirthSettings & {
591
+ onDate?: string;
592
+ lang?: string;
593
+ }, opts?: RequestOptions): Promise<T>;
594
+ /** Get a personalised weekly horoscope narrative computed from the natal Moon sign — personalised weekly reading using the birth chart's Moon degree. The input is the birth chart; pass `onDate` (YYYY-MM-DD) to read a day other than today. */
595
+ horoscopeWeeklyByMoon<T = unknown>(input: BirthInput & VedicBirthSettings & {
596
+ onDate?: string;
597
+ lang?: string;
598
+ }, opts?: RequestOptions): Promise<T>;
599
+ /** Get a narrative interpretation of a specific house lord's placement — where the lord of house N is placed in the chart and what it means for the areas of life that house governs. */
600
+ houseLord<T = unknown>(input: BirthInput & VedicBirthSettings & {
601
+ house: number;
602
+ lang?: string;
603
+ }, opts?: RequestOptions): Promise<T>;
604
+ /** Get a comprehensive narrative overview of all 12 house lords' placements in a birth chart — a full bhavesh analysis summarising how each house lord's position shapes the chart. */
605
+ houseLordsOverview<T = unknown>(input: BirthInput & VedicBirthSettings & {
606
+ lang?: string;
607
+ }, opts?: RequestOptions): Promise<T>;
608
+ /** Get the Jaimini Chara Karakas for a birth chart — the 8 karaka planets (Atmakaraka, Amatyakaraka, Bhratrukaraka, Matrukaraka, Putrakaraka, Gnatikaraka, Darakaraka, Dara/Swamsha) determined by planet degrees, with interpretation. */
609
+ karakas<T = unknown>(input: BirthInput & VedicBirthSettings & {
610
+ lang?: string;
611
+ }, opts?: RequestOptions): Promise<T>;
612
+ /** Get a narrative interpretation of the birth chart's lagna (ascendant) — describes the physical appearance, personality, health tendencies, and life approach associated with the rising sign, including first-house planets' influence. */
613
+ lagna<T = unknown>(input: BirthInput & VedicBirthSettings & {
614
+ lang?: string;
615
+ }, opts?: RequestOptions): Promise<T>;
616
+ /** Get a marriage and relationship narrative for a Vedic birth chart — analyses the 7th house lord, Venus, navamsa, and marriage-timing dashas to describe relationship characteristics, likely spouse traits, and timing of marriage. */
617
+ marriageOutlook<T = unknown>(input: BirthInput & VedicBirthSettings & {
618
+ lang?: string;
619
+ }, 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). */
621
+ milan<T = unknown>(input: {
622
+ boyDate: string;
623
+ boyTime: string;
624
+ boyTz: string;
625
+ girlDate: string;
626
+ girlTime: string;
627
+ girlTz: string;
628
+ lang?: string;
629
+ }, opts?: RequestOptions): Promise<T>;
630
+ /** Get a narrative interpretation of the natal Moon sign (Chandra Rashi) — covers emotional nature, mental tendencies, mother relationship, and instinctive responses associated with the Moon's sign placement. */
631
+ moonSign<T = unknown>(input: BirthInput & VedicBirthSettings & {
632
+ lang?: string;
633
+ }, opts?: RequestOptions): Promise<T>;
634
+ /** Get a narrative interpretation of the birth nakshatra (Janma Nakshatra) — covers personality, strengths, weaknesses, compatible nakshatras, ruling deity, symbol, and life path themes of the nakshatra the Moon occupied at birth. */
635
+ nakshatra<T = unknown>(input: BirthInput & VedicBirthSettings & {
636
+ lang?: string;
637
+ }, opts?: RequestOptions): Promise<T>;
638
+ /** Get a narrative interpretation of a specific planet's house placement in a Vedic birth chart — describes what that planet's position in that house means for the native's life areas, including classical significations and any classical yoga formation. */
639
+ planetInHouse<T = unknown>(input: BirthInput & VedicBirthSettings & {
640
+ planet: string;
641
+ lang?: string;
642
+ }, opts?: RequestOptions): Promise<T>;
643
+ /** Get a narrative interpretation of a specific planet's sign placement — describes how the planet expresses itself in that rashi, classical dignity/debility implications, and characteristic traits. */
644
+ planetInSign<T = unknown>(input: BirthInput & VedicBirthSettings & {
645
+ planet: string;
646
+ lang?: string;
647
+ }, opts?: RequestOptions): Promise<T>;
648
+ /** Get narrative interpretations for ALL planets' house placements in a birth chart in a single call — the full house-placement reading for every graha. */
649
+ planetsInHouses<T = unknown>(input: BirthInput & VedicBirthSettings & {
650
+ lang?: string;
651
+ }, opts?: RequestOptions): Promise<T>;
652
+ /** Get narrative interpretations for ALL planets' sign placements in a birth chart in a single call — the full sign-placement reading for every graha. */
653
+ planetsInSigns<T = unknown>(input: BirthInput & VedicBirthSettings & {
654
+ lang?: string;
655
+ }, opts?: RequestOptions): Promise<T>;
656
+ /** 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
+ profile<T = unknown>(input: BirthInput & VedicBirthSettings & {
658
+ lang?: string;
659
+ }, opts?: RequestOptions): Promise<T>;
660
+ /** The whole authored Vedic glossary: text that defines a concept (yogas, doshas, techniques) rather than interpreting one chart. Large (~800 KB); prefer `referenceFamily`. */
661
+ reference<T = unknown>(input?: {
662
+ lang?: string;
663
+ }, opts?: RequestOptions): Promise<T>;
664
+ /** The authored Vedic glossary for one concept family, e.g. `yoga`, `dosha`, `argala`. */
665
+ referenceFamily<T = unknown>(input: {
666
+ family: string;
667
+ lang?: string;
668
+ }, opts?: RequestOptions): Promise<T>;
669
+ /** 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;
673
+ lang?: string;
674
+ }, opts?: RequestOptions): Promise<T>;
675
+ /** 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;
679
+ lang?: string;
680
+ }, opts?: RequestOptions): Promise<T>;
681
+ /** 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;
685
+ lang?: string;
686
+ }, opts?: RequestOptions): Promise<T>;
687
+ /** 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. */
688
+ sunSign<T = unknown>(input: BirthInput & VedicBirthSettings & {
689
+ lang?: string;
690
+ }, opts?: RequestOptions): Promise<T>;
691
+ /** Get a narrative interpretation of the Ashtakavarga transit scores for a birth chart — written analysis of how current planetary transits score against the natal chart's benefic-point grid, with guidance on which transits are favourable or challenging. */
692
+ transitAshtakavarga<T = unknown>(input: {
693
+ birthDate: string;
694
+ birthTime: string;
695
+ birthTz: string;
696
+ lat: number;
697
+ lon: number;
698
+ lang?: string;
699
+ }, opts?: RequestOptions): Promise<T>;
700
+ /** 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;
704
+ lang?: string;
705
+ }, 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;
710
+ lang?: string;
711
+ }, opts?: RequestOptions): Promise<T>;
712
+ /** 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. */
713
+ varshaphalThemes<T = unknown>(input: {
714
+ birthDate: string;
715
+ birthTime: string;
716
+ birthTz: string;
717
+ lat: number;
718
+ lon: number;
719
+ year: number;
720
+ lang?: string;
721
+ }, opts?: RequestOptions): Promise<T>;
722
+ /** Personalised yearly Bhavishyafal (annual horoscope) for a target year. */
723
+ yearlyBhavishyafal<T = unknown>(input: {
724
+ date: string;
725
+ time: string;
726
+ tz: string;
727
+ lat: number;
728
+ lon: number;
729
+ year: number;
730
+ }, opts?: RequestOptions): Promise<T>;
731
+ /** Narrative interpretation of a specific yoga in the chart. */
732
+ yoga<T = unknown>(input: BirthInput & VedicBirthSettings & {
733
+ id: string;
734
+ lang?: string;
735
+ }, opts?: RequestOptions): Promise<T>;
736
+ /** Get a narrative of all major Vedic yogas present in a birth chart — Raja Yoga, Dhana Yoga, Parivartana Yoga, Kemadruma Yoga, Neecha Bhanga, Panchamahapurusha, and others — with presence, strength, and what each yoga means for the native. */
737
+ yogas<T = unknown>(input: BirthInput & VedicBirthSettings & {
738
+ lang?: string;
739
+ }, opts?: RequestOptions): Promise<T>;
740
+ }
741
+
742
+ declare class Numerology {
743
+ private readonly _c;
744
+ constructor(_c: ClientCore);
745
+ /** Compute the advanced Vedic numerology profile from a name (and optionally DOB): Maturity Number (life purpose emerging after 40), Karmic Lessons (missing digits = undeveloped qualities), Sub-conscious Self (9 minus karmic lessons), Hidden Passion (dominant talent), and Balance Number (crisis response quality). */
746
+ advanced<T = unknown>(input: {
747
+ name: string;
748
+ dob?: string;
749
+ lang?: string;
750
+ }, opts?: RequestOptions): Promise<T>;
751
+ /** Compute the four Vedic Challenge Numbers from a birth date — the life obstacles and developmental lessons to be mastered in different life stages (CH1 early life, CH2 middle life, CH3 major challenge, CH4 later life). */
752
+ challenges<T = unknown>(input: {
753
+ dob: string;
754
+ refDate?: string;
755
+ lang?: string;
756
+ }, opts?: RequestOptions): Promise<T>;
757
+ /** Compute the Bhagyank / Conductor number — derived from the full date of birth (DD+MM+YYYY reduced to a single digit). */
758
+ conductor<T = unknown>(input: {
759
+ dob: string;
760
+ lang?: string;
761
+ }, opts?: RequestOptions): Promise<T>;
762
+ /** Compute the Destiny number — derived from all letters of the full name (vowels + consonants). */
763
+ destiny<T = unknown>(input: {
764
+ name: string;
765
+ lang?: string;
766
+ }, opts?: RequestOptions): Promise<T>;
767
+ /** Compute the Mulank / Driver number — the single-digit number derived from the day of birth (1–31, reduced to 1–9, preserving 11/22/33). */
768
+ driver<T = unknown>(input: {
769
+ dob: string;
770
+ lang?: string;
771
+ }, opts?: RequestOptions): Promise<T>;
772
+ /** Full numerology report (driver, conductor, soul, personality, destiny). */
773
+ full<T = unknown>(input?: NumerologyInput, opts?: RequestOptions): Promise<T>;
774
+ /** Compute the Personality number — derived from the consonants of the full name. */
775
+ personality<T = unknown>(input: {
776
+ name: string;
777
+ lang?: string;
778
+ }, opts?: RequestOptions): Promise<T>;
779
+ /** Compute the Personal Year, Personal Month, and Personal Day numbers for any date — the time-transiting layer of Vedic numerology that shows the numerological climate for a specific period. */
780
+ personalPeriods<T = unknown>(input: {
781
+ dob: string;
782
+ refDate?: string;
783
+ lang?: string;
784
+ }, opts?: RequestOptions): Promise<T>;
785
+ /** Compute the Soul Urge number — derived from the vowels of the full name. */
786
+ soul<T = unknown>(input: {
787
+ name: string;
788
+ lang?: string;
789
+ }, opts?: RequestOptions): Promise<T>;
790
+ }
791
+
792
+ declare class Panchang {
793
+ private readonly _c;
794
+ constructor(_c: ClientCore);
795
+ /** Abhijit Muhurat (auspicious window around solar noon). */
796
+ abhijit<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
797
+ /** Full advanced panchang: everything in basic plus all muhurta windows, Choghadiya, Hindu month, samvat and more. */
798
+ advanced<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
799
+ /** Amrit Kalam auspicious window. */
800
+ amritKalam<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
801
+ /** Composite basic panchang in one call: tithi, nakshatra, yoga, karana, vara, sun/moon rise & set. */
802
+ basic<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
803
+ /** Brahma Muhurat window before sunrise. */
804
+ brahmaMuhurat<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
805
+ /** Choghadiya periods (day + night). */
806
+ choghadiya<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
807
+ /** Durmuhurta inauspicious periods for the day. */
808
+ durmuhurta<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
809
+ /** Gulika Kaal window. */
810
+ gulika<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
811
+ /** Hindu lunar month, paksha, samvat and adhik/kshaya detection. */
812
+ hinduMonth<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
813
+ /** Planetary hours (horas) for the day, or the hora at a given time. */
814
+ hora<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
815
+ /** Get the Dinman (day length) and Ratriman (night length) for a date — the exact duration of daytime from sunrise to sunset and nighttime from sunset to next sunrise, in ghatis (1 ghati = 24 minutes). */
816
+ horaDinman<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
817
+ /** Current karana (half-tithi). */
818
+ karana<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
819
+ /** Lagna (rising sign) table for the day with start/end times for each sign. */
820
+ lagnaTable<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
821
+ /** Full-month panchang calendar (one entry per day). tz accepts an IANA name ("Asia/Kolkata"), a fixed offset ("+05:30") or decimal hours ("5.5"). Pass include: "sheet" for a complete printable Hindu calendar page: per-day tithi/nakshatra/moon-sign end-times ("27:07+" notation), kshaya days, moonrise/moonset, Hindu month, Vikram/Shaka samvat, moon phase and every festival of the day, plus the page header. */
822
+ monthly<T = unknown>(input: {
823
+ lat: number;
824
+ lon: number;
825
+ alt?: number;
826
+ tz?: string;
827
+ year: number;
828
+ month: number;
829
+ include?: string;
830
+ locale?: string;
831
+ monthSystem?: string;
832
+ ayanamsa?: string;
833
+ }, opts?: RequestOptions): Promise<T>;
834
+ /** Moonrise and moonset times. */
835
+ moonriseMoonset<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
836
+ /** Moon's nakshatra with pada, lord and start/end at the moment. */
837
+ nakshatra<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
838
+ /** Personalised daily Tara Bala prediction relative to a birth nakshatra (index 0-26). */
839
+ nakshatraPrediction<T = unknown>(input: MomentInput & VedicMomentSettings & {
840
+ birthNak: number;
841
+ }, opts?: RequestOptions): Promise<T>;
842
+ /** Panchaka classification at the moment. */
843
+ panchaka<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
844
+ /** Pradosh Kaal twilight window after sunset. */
845
+ pradoshKaal<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
846
+ /** Rahu Kaal inauspicious window. */
847
+ rahuKaal<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
848
+ /** Get solar Sankranti (Sun's sign ingress) dates for a year — the exact moment the Sun enters each of the 12 sidereal signs, including Makar Sankranti (Capricorn), Mesh Sankranti (Aries/New Year), and all others. */
849
+ sankranti<T = unknown>(input: {
850
+ date: string;
851
+ tz: string;
852
+ }, opts?: RequestOptions): Promise<T>;
853
+ /** Siddha Yoga vara+nakshatra auspicious combination check. */
854
+ siddhaYoga<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
855
+ /** Quick 5-element panchang strip (tithi, nakshatra, yoga, karana, vara) plus sunrise/sunset. */
856
+ summary<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
857
+ /** Sunrise and sunset times plus day length. */
858
+ sunriseSunset<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
859
+ /** Current tithi (lunar day) with paksha, lord and transition timing. */
860
+ tithi<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
861
+ /** Hindu weekday (vara) and its ruling planet. */
862
+ vara<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
863
+ /** Varjyam forbidden window based on the Moon's nakshatra. */
864
+ varjyam<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
865
+ /** Yamaganda inauspicious window. */
866
+ yamaganda<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
867
+ /** Current panchang yoga (one of 27). */
868
+ yoga<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
869
+ }
870
+
871
+ declare class PlanetMoments {
872
+ private readonly _c;
873
+ constructor(_c: ClientCore);
874
+ /** 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. */
875
+ combustionWindow<T = unknown>(input: {
876
+ planet: string;
877
+ date: string;
878
+ time?: string;
879
+ tz: string;
880
+ maxDays?: number;
881
+ }, opts?: RequestOptions): Promise<T>;
882
+ /** A planet's sign ingresses (sankranti) in a date range. */
883
+ ingress<T = unknown>(input: {
884
+ planet: string;
885
+ date: string;
886
+ time?: string;
887
+ tz: string;
888
+ maxDays?: number;
889
+ }, opts?: RequestOptions): Promise<T>;
890
+ /** A planet's retrograde windows (station retro -> station direct) in a date range. */
891
+ retrogradeWindow<T = unknown>(input: {
892
+ planet: string;
893
+ date: string;
894
+ time?: string;
895
+ tz: string;
896
+ maxDays?: number;
897
+ }, opts?: RequestOptions): Promise<T>;
898
+ /** Get the current speed and motion state of a planet — degrees per day, whether it is direct/retrograde/stationary, and its speed relative to mean motion. */
899
+ speed<T = unknown>(input: {
900
+ planet: string;
901
+ date: string;
902
+ time?: string;
903
+ tz: string;
904
+ }, opts?: RequestOptions): Promise<T>;
905
+ }
906
+
907
+ declare class Prashna {
908
+ private readonly _c;
909
+ constructor(_c: ClientCore);
910
+ /** Cast a Prashna (horary) chart and compute the classical yes/no answer. */
911
+ answer<T = unknown>(input: MomentInput & VedicMomentSettings & {
912
+ house: number;
913
+ }, opts?: RequestOptions): Promise<T>;
914
+ /** Compute the Arudha Lagna of a Prashna chart — the perceived image/manifestation of the question's subject. */
915
+ arudha<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
916
+ /** Cast the full Prashna (horary) chart for the moment a question is asked — returns lagna, all planet placements, houses, and panchang at the moment of the question. */
917
+ chart<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
918
+ /** Get the lagna lord analysis for a Prashna chart — where the lagna lord is placed, its strength, and what it indicates about the querent's situation and chances of success. */
919
+ lagnaLord<T = unknown>(input: MomentInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
920
+ /** Get the KP significators for a Prashna chart — lists planets significating the houses relevant to the question (e.g. */
921
+ significators<T = unknown>(input: MomentInput & VedicMomentSettings & {
922
+ house: number;
923
+ }, opts?: RequestOptions): Promise<T>;
924
+ }
925
+
926
+ declare class Remedies {
927
+ private readonly _c;
928
+ constructor(_c: ClientCore);
929
+ /** Remedy package attached to a specific rule id. */
930
+ byRuleId<T = unknown>(input: {
931
+ id: string;
932
+ lang?: string;
933
+ }, opts?: RequestOptions): Promise<T>;
934
+ /** Full details of a daan (charity/donation) remedy by id — what to donate, to whom, and when. */
935
+ daan<T = unknown>(input: {
936
+ id: string;
937
+ locale?: string;
938
+ }, opts?: RequestOptions): Promise<T>;
939
+ /** Lal Kitab remedies for a specific planet-in-house placement (e.g. saturn in house 8). */
940
+ lalkitabForPlacement<T = unknown>(input: {
941
+ planet: string;
942
+ house: string;
943
+ locale?: string;
944
+ }, opts?: RequestOptions): Promise<T>;
945
+ /** List Lal Kitab remedies (upay), optionally filtered by planet. */
946
+ lalkitabList<T = unknown>(input?: {
947
+ planet?: string;
948
+ locale?: string;
949
+ }, opts?: RequestOptions): Promise<T>;
950
+ /** Full details of a mantra remedy by id. */
951
+ mantra<T = unknown>(input: {
952
+ id: string;
953
+ lang?: string;
954
+ }, opts?: RequestOptions): Promise<T>;
955
+ /** Full details of a pooja remedy by id. */
956
+ pooja<T = unknown>(input: {
957
+ id: string;
958
+ lang?: string;
959
+ }, opts?: RequestOptions): Promise<T>;
960
+ /** Full details of a rudraksha remedy by id — mukhi count, ruling planet, wearing procedure. */
961
+ rudraksha<T = unknown>(input: {
962
+ id: string;
963
+ locale?: string;
964
+ }, opts?: RequestOptions): Promise<T>;
965
+ /** Get Vedic astrological remedies for a birth chart — personalised remedies based on weak planets, doshas, and challenging dashas. */
966
+ vedic<T = unknown>(input: BirthInput & VedicBirthSettings & {
967
+ category?: string;
968
+ lang?: string;
969
+ }, opts?: RequestOptions): Promise<T>;
970
+ /** Full details of a vrat remedy by id. */
971
+ vrat<T = unknown>(input: {
972
+ id: string;
973
+ lang?: string;
974
+ }, opts?: RequestOptions): Promise<T>;
975
+ /** Full details of a yantra remedy by id — purpose, installation procedure, direction, day, and mantra. */
976
+ yantra<T = unknown>(input: {
977
+ id: string;
978
+ locale?: string;
979
+ }, opts?: RequestOptions): Promise<T>;
980
+ }
981
+
982
+ declare class Reports {
983
+ private readonly _c;
984
+ constructor(_c: ClientCore);
985
+ /** Generate a comprehensive Dasha Analysis report — the full Vimshottari dasha timeline with narrative interpretation for each Mahadasha period, key life events timing, and dasha-transit correlations. */
986
+ dashaAnalysis<T = unknown>(input: BirthInput & VedicBirthSettings & {
987
+ name?: string;
988
+ place?: string;
989
+ lang?: string;
990
+ }, opts?: RequestOptions): Promise<T>;
991
+ /** Generate a detailed daily horoscope report for a Moon sign — structured report with separate sections for career, love, finance, health, and daily guidance. */
992
+ horoscopeDaily<T = unknown>(input: RashiInput & {
993
+ lang?: string;
994
+ }, opts?: RequestOptions): Promise<T>;
995
+ /** Generate a detailed monthly horoscope report for a Moon sign — structured report covering the month's major transit themes, weekly breakdown, and guidance for career, relationships, and finance for the full month. `month` is `YYYY-MM`. */
996
+ horoscopeMonthly<T = unknown>(input: RashiInput & {
997
+ month: string;
998
+ lang?: string;
999
+ }, opts?: RequestOptions): Promise<T>;
1000
+ /** 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. */
1001
+ horoscopeWeekly<T = unknown>(input: RashiInput & {
1002
+ lang?: string;
1003
+ }, opts?: RequestOptions): Promise<T>;
1004
+ /** 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. */
1005
+ kundliBrihad<T = unknown>(input: BirthInput & VedicBirthSettings & {
1006
+ name?: string;
1007
+ place?: string;
1008
+ lang?: string;
1009
+ }, opts?: RequestOptions): Promise<T>;
1010
+ /** Generate a Detailed Kundli report — birth chart report with the planet positions table, full house-by-house analysis, major yogas, key doshas (Mangal/Kaal Sarp/Pitra), the Vimshottari Mahadasha timeline (current + upcoming), and birth panchang. For all divisional charts (D9/D10), Shadbala strengths, and life-area predictions, use the Brihad report. */
1011
+ kundliDetailed<T = unknown>(input: BirthInput & VedicBirthSettings & {
1012
+ name?: string;
1013
+ place?: string;
1014
+ lang?: string;
1015
+ }, opts?: RequestOptions): Promise<T>;
1016
+ /** Generate a Lite Kundli report — a concise birth chart summary with lagna, Moon sign, nakshatra, key planets, current dasha, and a brief personality reading. */
1017
+ kundliLite<T = unknown>(input: BirthInput & VedicBirthSettings & {
1018
+ name?: string;
1019
+ place?: string;
1020
+ lang?: string;
1021
+ }, opts?: RequestOptions): Promise<T>;
1022
+ /** Generate a comprehensive Mangal Dosha report — full analysis of Mangal Dosha presence, sub-rules, all cancellation conditions checked, severity, impact on marriage, and detailed remedies with specific mantras, pujas, and gemstone guidance. */
1023
+ mangalDosha<T = unknown>(input: BirthInput & VedicBirthSettings & {
1024
+ name?: string;
1025
+ place?: string;
1026
+ lang?: string;
1027
+ }, opts?: RequestOptions): Promise<T>;
1028
+ /** Generate a comprehensive Match Making (Kundli Milan) report for a couple — full Ashtakoota analysis with all 8 kootas scored, Mangal Dosha compatibility, Dasha synchrony, Navamsa compatibility, and an overall written recommendation. */
1029
+ matchMaking<T = unknown>(input: BoyGirlInput & VedicMomentSettings & {
1030
+ boyName?: string;
1031
+ girlName?: string;
1032
+ boyPlace?: string;
1033
+ girlPlace?: string;
1034
+ lang?: string;
1035
+ }, opts?: RequestOptions): Promise<T>;
1036
+ /** Generate a comprehensive Numerology report — calculates all key numbers (Driver/Mulank, Conductor/Bhagyank, Name number, Soul Urge, Personality, Destiny) from name and date of birth, with complete interpretation of each number's meaning and their combined influence. */
1037
+ numerology<T = unknown>(input: {
1038
+ name: string;
1039
+ place?: string;
1040
+ dob: string;
1041
+ lang?: string;
1042
+ }, opts?: RequestOptions): Promise<T>;
1043
+ /** Generate a comprehensive Sade Sati report — covers current Sade Sati status, all past and upcoming cycles from birth to age 90, phase-by-phase narrative for the current or next cycle, and detailed remedies (mantras, donations, Shani puja guidance). */
1044
+ sadeSati<T = unknown>(input: BirthInput & VedicBirthSettings & {
1045
+ name?: string;
1046
+ place?: string;
1047
+ lang?: string;
1048
+ }, opts?: RequestOptions): Promise<T>;
1049
+ /** Generate a comprehensive Varshaphal (Solar Return) annual report — full annual chart with varsha lord, muntha, annual lagna, Tajika yogas, Mudda dasha timeline, and predictions for all 12 life areas for the current solar-return year. */
1050
+ varshaphal<T = unknown>(input: BirthInput & VedicBirthSettings & {
1051
+ name?: string;
1052
+ place?: string;
1053
+ year: number;
1054
+ lang?: string;
1055
+ }, opts?: RequestOptions): Promise<T>;
1056
+ }
1057
+
1058
+ declare class Tarot {
1059
+ private readonly _c;
1060
+ constructor(_c: ClientCore);
1061
+ /** Get the complete details for a single tarot card by ID — name, suit, element, archetype, upright and reversed meanings, keywords, and yes/no tendency. */
1062
+ card<T = unknown>(input: {
1063
+ id: string;
1064
+ }, opts?: RequestOptions): Promise<T>;
1065
+ /** List tarot cards from the 78-card Rider-Waite deck with upright/reversed meanings, keywords, and yes/no tendency. */
1066
+ cards<T = unknown>(input?: {
1067
+ suit?: string;
1068
+ search?: string;
1069
+ }, opts?: RequestOptions): Promise<T>;
1070
+ /** Get the card of the day — a deterministic daily tarot card that is the same for everyone on a given date. */
1071
+ daily<T = unknown>(input?: {
1072
+ date?: string;
1073
+ }, opts?: RequestOptions): Promise<T>;
1074
+ /** Draw a tarot spread with a chosen layout and optional topic focus. */
1075
+ spread<T = unknown>(input: {
1076
+ type: string;
1077
+ topic?: string;
1078
+ seed?: number;
1079
+ }, opts?: RequestOptions): Promise<T>;
1080
+ /** Get a yes/no tarot answer — draws one card, returns yes/no/maybe based on the card's natural tendency modified by orientation, with reasoning. */
1081
+ yesNo<T = unknown>(input?: {
1082
+ seed?: number;
1083
+ }, opts?: RequestOptions): Promise<T>;
1084
+ }
1085
+
1086
+ declare class Transit {
1087
+ private readonly _c;
1088
+ constructor(_c: ClientCore);
1089
+ /** Score current planetary transits against a natal chart using Ashtakavarga — shows which houses transiting planets are moving through and how many benefic points those signs have in the natal chart. */
1090
+ ashtakavarga<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1091
+ /** List the pairs of planets occupying the same sidereal sign at a moment (planetary conjunctions by sign). Takes a date, not a birth chart; defaults to today. */
1092
+ doubleTransit<T = unknown>(input?: InstantInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1093
+ /** Current sidereal positions of all 9 grahas (defaults to now). */
1094
+ positions<T = unknown>(input?: InstantInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1095
+ /** Saturn Sade Sati status (rising/peak/setting) relative to the birth Moon. */
1096
+ 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;
1102
+ }, opts?: RequestOptions): Promise<T>;
1103
+ /** 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
+ smallPanotiHistory<T = unknown>(input: BirthInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1105
+ /** 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
+ tarabala<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1107
+ /** 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
+ vedha<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1109
+ }
1110
+
1111
+ declare class Varshaphal {
1112
+ private readonly _c;
1113
+ constructor(_c: ClientCore);
1114
+ /** Varshaphal (annual solar-return) chart for a year. */
1115
+ chart<T = unknown>(input: BirthInput & VedicBirthSettings & {
1116
+ year: number;
1117
+ }, opts?: RequestOptions): Promise<T>;
1118
+ /** Tajika Harsha Bala for the annual chart. */
1119
+ harshaBala<T = unknown>(input: BirthInput & VedicBirthSettings & {
1120
+ year: number;
1121
+ }, 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. */
1123
+ lord<T = unknown>(input: BirthInput & VedicBirthSettings & {
1124
+ year: number;
1125
+ }, opts?: RequestOptions): Promise<T>;
1126
+ /** Varshaphal Mudda Dasha periods for the solar-return year. */
1127
+ muddaDasha<T = unknown>(input: BirthInput & VedicBirthSettings & {
1128
+ year: number;
1129
+ }, opts?: RequestOptions): Promise<T>;
1130
+ /** Get Muntha placement for a Varshaphal year — Muntha moves one sign per year from birth lagna and its house position in the annual chart is a key indicator of the year's themes. */
1131
+ muntha<T = unknown>(input: BirthInput & VedicBirthSettings & {
1132
+ year: number;
1133
+ }, opts?: RequestOptions): Promise<T>;
1134
+ /** Get the precise Julian Day (JD) and calendar datetime of the solar return for a given year — the exact moment the Sun returns to its natal longitude. */
1135
+ solarReturnJd<T = unknown>(input: BirthInput & VedicBirthSettings & {
1136
+ year: number;
1137
+ }, opts?: RequestOptions): Promise<T>;
1138
+ /** Get Tajika Yogas in the Varshaphal annual chart — Ikkaval, Induvara, Ithasala, Ishrafa, Nakta, Yamaya, Manau, Khallasara, Duphali-Kuttha, and other Tajika aspect-based yogas that indicate the tone of the solar-return year. */
1139
+ yoga<T = unknown>(input: BirthInput & VedicBirthSettings & {
1140
+ year: number;
1141
+ }, opts?: RequestOptions): Promise<T>;
1142
+ }
1143
+
1144
+ declare class WesternAstrocartography {
1145
+ private readonly _c;
1146
+ constructor(_c: ClientCore);
1147
+ /** Compute Local Space astrocartography — the directions from an observer's location in which each natal planet rises, sets, culminates, or anti-culminates. */
1148
+ localSpace<T = unknown>(input: WesternNatalInput & {
1149
+ observerLat: number;
1150
+ observerLon: number;
1151
+ }, opts?: RequestOptions): Promise<T>;
1152
+ /** Astrocartography planet lines (ASC/DSC/MC/IC) for mapping. */
1153
+ planetLines<T = unknown>(input: WesternMomentInput & {
1154
+ latStep?: number;
1155
+ }, opts?: RequestOptions): Promise<T>;
1156
+ }
1157
+ declare class WesternCompatibility {
1158
+ private readonly _c;
1159
+ constructor(_c: ClientCore);
1160
+ /** Get the Western sun-sign compatibility between two zodiac signs — score 0–100, band (excellent/good/fair/challenging), aspect basis (trine/sextile/square etc.), element interaction, strengths, and challenges. */
1161
+ sunSign<T = unknown>(input: {
1162
+ signA: string;
1163
+ signB: string;
1164
+ }, opts?: RequestOptions): Promise<T>;
1165
+ }
1166
+ declare class WesternComposite {
1167
+ private readonly _c;
1168
+ constructor(_c: ClientCore);
1169
+ /** Get aspects in the composite (midpoint) chart for two people — shows how the relationship's combined energy is configured. */
1170
+ aspects<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1171
+ /** Composite (midpoint) relationship chart. */
1172
+ chart<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1173
+ /** Compute the house cusps of the Composite chart for two people — the midpoint chart combining both natal charts to represent the relationship itself. */
1174
+ houses<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1175
+ /** Compute the planet placements in the Composite chart for two people — midpoint positions for all planets in the relationship chart. */
1176
+ planets<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1177
+ }
1178
+ declare class WesternDavison {
1179
+ private readonly _c;
1180
+ constructor(_c: ClientCore);
1181
+ /** Get aspects in the Davison relationship chart. */
1182
+ aspects<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1183
+ /** Compute the Davison relationship chart — an alternative to the composite chart that uses the midpoint of the two birth times rather than midpoint longitudes. */
1184
+ chart<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1185
+ /** 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). */
1186
+ houses<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1187
+ /** Compute the planet placements in the Davison Relationship chart — all planet positions in the Davison chart's tropical zodiac. */
1188
+ planets<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1189
+ }
1190
+ declare class WesternDignities {
1191
+ private readonly _c;
1192
+ constructor(_c: ClientCore);
1193
+ /** Compute the Almuten Figuris — the planet with the highest combined essential dignity score at the Ascendant degree. */
1194
+ almuten<T = unknown>(input: {
1195
+ ascLon: number;
1196
+ diurnal?: string;
1197
+ scheme?: string;
1198
+ }, opts?: RequestOptions): Promise<T>;
1199
+ /** Get the bound (term) ruler for a zodiac degree and the full sign breakdown — shows which planet rules each of the five bounds within a sign. */
1200
+ bounds<T = unknown>(input: {
1201
+ lon: number;
1202
+ scheme?: string;
1203
+ diurnal?: string;
1204
+ }, opts?: RequestOptions): Promise<T>;
1205
+ /** Get the face (decan) ruler for a zodiac degree using the Chaldean order — shows which of the 36 faces the degree falls in and its planetary ruler. */
1206
+ face<T = unknown>(input: {
1207
+ lon: number;
1208
+ scheme?: string;
1209
+ diurnal?: string;
1210
+ }, opts?: RequestOptions): Promise<T>;
1211
+ /** Essential dignities for a planet (domicile/exaltation/triplicity/bound/face + almuten). */
1212
+ planet<T = unknown>(input: {
1213
+ planet: string;
1214
+ lon: number;
1215
+ diurnal?: boolean;
1216
+ scheme?: string;
1217
+ }, opts?: RequestOptions): Promise<T>;
1218
+ /** Compute essential dignities and mutual receptions for a Western birth chart — each planet's essential dignity state (domicile, exaltation, triplicity, term, face, detriment, fall), any mutual reception pairs, and the overall dignity score. */
1219
+ receptions<T = unknown>(input?: {
1220
+ sun?: number;
1221
+ moon?: number;
1222
+ mercury?: number;
1223
+ venus?: number;
1224
+ mars?: number;
1225
+ jupiter?: number;
1226
+ saturn?: number;
1227
+ }, opts?: RequestOptions): Promise<T>;
1228
+ /** Get the triplicity (element) ruler for a zodiac degree — shows which planet rules by fire/earth/air/water triplicity, with day and night rulers. */
1229
+ triplicity<T = unknown>(input: {
1230
+ lon: number;
1231
+ scheme?: string;
1232
+ diurnal?: string;
1233
+ }, opts?: RequestOptions): Promise<T>;
1234
+ }
1235
+ declare class WesternEclipses {
1236
+ private readonly _c;
1237
+ constructor(_c: ClientCore);
1238
+ /** Upcoming solar and lunar eclipses (default 12 months ahead). */
1239
+ upcoming<T = unknown>(input?: {
1240
+ months?: number;
1241
+ }, opts?: RequestOptions): Promise<T>;
1242
+ /** Check whether upcoming eclipses are visible from a specific location — returns visibility type (total, partial, annular, not visible) and times of contact. */
1243
+ visibility<T = unknown>(input: {
1244
+ lat: number;
1245
+ lon: number;
1246
+ startDate: string;
1247
+ endDate: string;
1248
+ }, opts?: RequestOptions): Promise<T>;
1249
+ }
1250
+ declare class WesternHeliocentric {
1251
+ private readonly _c;
1252
+ constructor(_c: ClientCore);
1253
+ /** Heliocentric (Sun-centred) planetary positions. */
1254
+ planets<T = unknown>(input: WesternMomentInput, opts?: RequestOptions): Promise<T>;
1255
+ }
1256
+ declare class WesternHoroscope {
1257
+ private readonly _c;
1258
+ constructor(_c: ClientCore);
1259
+ /** Get the daily Western horoscope for a sun sign. */
1260
+ daily<T = unknown>(input: {
1261
+ sign: string;
1262
+ date: string;
1263
+ tone?: string;
1264
+ }, opts?: RequestOptions): Promise<T>;
1265
+ /** Get the monthly Western horoscope for a sun sign. */
1266
+ monthly<T = unknown>(input: {
1267
+ sign: string;
1268
+ yearMonth: string;
1269
+ tone?: string;
1270
+ }, opts?: RequestOptions): Promise<T>;
1271
+ /** Get the weekly Western horoscope for a sun sign. */
1272
+ weekly<T = unknown>(input: {
1273
+ sign: string;
1274
+ weekStart: string;
1275
+ tone?: string;
1276
+ }, opts?: RequestOptions): Promise<T>;
1277
+ }
1278
+ declare class WesternInterpretation {
1279
+ private readonly _c;
1280
+ constructor(_c: ClientCore);
1281
+ /** Narrative interpretation for a natal/synastry aspect (e.g. Sun square Mars). */
1282
+ aspect<T = unknown>(input: {
1283
+ planetA: string;
1284
+ planetB: string;
1285
+ aspect: string;
1286
+ context?: string;
1287
+ }, opts?: RequestOptions): Promise<T>;
1288
+ /** Narrative interpretation for a transiting planet aspecting a natal planet. */
1289
+ transit<T = unknown>(input: {
1290
+ transitPlanet: string;
1291
+ natalPlanet: string;
1292
+ aspect: string;
1293
+ }, opts?: RequestOptions): Promise<T>;
1294
+ }
1295
+ declare class WesternLunar {
1296
+ private readonly _c;
1297
+ constructor(_c: ClientCore);
1298
+ /** Get the natal Moon phase at birth — phase angle, illumination percentage, 8-named phase (new moon through waning crescent), and age in days since last new moon. */
1299
+ phase<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1300
+ }
1301
+ declare class WesternNarrative {
1302
+ private readonly _c;
1303
+ constructor(_c: ClientCore);
1304
+ /** Get the authored narrative for a zodiac decan (10° division of a sign). */
1305
+ decan<T = unknown>(input: {
1306
+ sign: string;
1307
+ decan: number;
1308
+ lang?: string;
1309
+ }, opts?: RequestOptions): Promise<T>;
1310
+ /** Get the authored narrative interpretation for a named fixed star in a natal chart. */
1311
+ fixedStar<T = unknown>(input: {
1312
+ star: string;
1313
+ lang?: string;
1314
+ }, opts?: RequestOptions): Promise<T>;
1315
+ /** Get a composed narrative summary of a Western natal chart — authored prose covering Ascendant, Sun, Moon placements and key aspect highlights. */
1316
+ natalSummary<T = unknown>(input: WesternNatalInput & {
1317
+ verbosity?: string;
1318
+ }, opts?: RequestOptions): Promise<T>;
1319
+ /** Get the authored Sabian symbol and interpretation for a specific zodiac degree (1–360, where 1 = Aries 1° and 360 = Pisces 30°). */
1320
+ sabian<T = unknown>(input: {
1321
+ degree: number;
1322
+ lang?: string;
1323
+ }, opts?: RequestOptions): Promise<T>;
1324
+ /** Get the Firdaria time-lord narrative for a given planet — the Hellenistic planetary period system (similar to Vimshottari but Ptolemaic). */
1325
+ timelordFirdaria<T = unknown>(input: {
1326
+ lord: string;
1327
+ lang?: string;
1328
+ }, opts?: RequestOptions): Promise<T>;
1329
+ /** Get the authored narrative for the annual profection house — a description of the life themes activated in this profection year. */
1330
+ timelordProfection<T = unknown>(input: {
1331
+ house: number;
1332
+ lang?: string;
1333
+ }, opts?: RequestOptions): Promise<T>;
1334
+ /** Get the authored narrative for a Zodiacal Releasing planetary lord — describes the life-period themes when a given planet is lord in the ZR system. */
1335
+ timelordZr<T = unknown>(input: {
1336
+ lord: string;
1337
+ lang?: string;
1338
+ }, opts?: RequestOptions): Promise<T>;
1339
+ /** Get a composed narrative summary of current transits to a natal chart — authored prose for the most exact active transits at the given moment. */
1340
+ transitSummary<T = unknown>(input: NatalTransitInput & VedicMomentSettings & {
1341
+ verbosity?: string;
1342
+ }, opts?: RequestOptions): Promise<T>;
1343
+ /** Get the annual solar-return theme for a sun sign — a deep interpretive essay on the year's archetypal themes for that sign. */
1344
+ yearly<T = unknown>(input: {
1345
+ sign: string;
1346
+ lang?: string;
1347
+ }, opts?: RequestOptions): Promise<T>;
1348
+ }
1349
+ declare class WesternNatal {
1350
+ private readonly _c;
1351
+ constructor(_c: ClientCore);
1352
+ /** Antiscia (solstice points) and contra-antiscia. */
1353
+ antiscia<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1354
+ /** Compute the Western (tropical) natal Ascendant — rising sign, degree, and Midheaven in the tropical zodiac. */
1355
+ ascendant<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1356
+ /** 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. */
1357
+ aspectPatterns<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1358
+ /** All natal aspects with orbs and partile flags. */
1359
+ aspects<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1360
+ /** A single asteroid by MPC number. */
1361
+ asteroid<T = unknown>(input: WesternNatalInput & {
1362
+ number: number | string;
1363
+ }, opts?: RequestOptions): Promise<T>;
1364
+ /** Ceres, Pallas, Juno, Vesta plus Chiron. */
1365
+ asteroidsBigFourPlus<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1366
+ /** Get natal positions for the centaur bodies: Pholus, Nessus, Asbolus, and Chariklo. */
1367
+ centaurs<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1368
+ /** Western (tropical) natal chart: planets, ascendant, MC, houses and aspects. */
1369
+ chart<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1370
+ /** Classify the natal chart into one of the seven Jones planetary distribution patterns: Splash, Bundle, Locomotive, Bowl, Bucket, See-Saw, or Splay. */
1371
+ chartShape<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1372
+ /** Planetary declinations, parallels and out-of-bounds. */
1373
+ declinations<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1374
+ /** Get the chart dominance profile — dominant element (fire/earth/air/water), dominant modality (cardinal/fixed/mutable), most aspected planet, Lilly dignity ranking of traditional planets, and hemisphere balance. */
1375
+ dominant<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1376
+ /** Whether a named fixed star is conjunct any natal point. */
1377
+ fixedStar<T = unknown>(input: WesternNatalInput & {
1378
+ name: string;
1379
+ }, opts?: RequestOptions): Promise<T>;
1380
+ /** Conjunctions between natal planets and major fixed stars. */
1381
+ fixedStars<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1382
+ /** Nth harmonic chart (2-32). */
1383
+ harmonic<T = unknown>(input: WesternNatalInput & {
1384
+ n: number | string;
1385
+ }, opts?: RequestOptions): Promise<T>;
1386
+ /** Find harmonic aspects across multiple harmonics simultaneously — quintiles (H5), septiles (H7), noviles (H9), etc. */
1387
+ harmonicAspects<T = unknown>(input: WesternNatalInput & {
1388
+ harmonics?: string;
1389
+ }, opts?: RequestOptions): Promise<T>;
1390
+ /** Western tropical house cusps + Ascendant and MC. */
1391
+ houses<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1392
+ /** Get all Lilith positions: Mean Black Moon Lilith, True Black Moon Lilith, Osculating (Interpolated) Lilith, and asteroid 1181 Lilith. */
1393
+ lilithSet<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1394
+ /** A single Arabic Lot (fortune|spirit|eros|...). */
1395
+ lot<T = unknown>(input: WesternNatalInput & {
1396
+ name: string;
1397
+ }, opts?: RequestOptions): Promise<T>;
1398
+ /** All Hellenistic Arabic Parts (Lots). */
1399
+ lots<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1400
+ /** 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. */
1401
+ mc<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1402
+ /** All planet-pair midpoints and activations. */
1403
+ midpoints<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1404
+ /** Ebertin 90-degree dial midpoint tree. */
1405
+ midpointTree<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1406
+ /** Check which planets are Out of Bounds (OOB) in a Western natal chart — planets with declination beyond ±23°26′ (the Sun's maximum), considered to operate outside normal rules and with heightened, unconventional energy. */
1407
+ outOfBounds<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1408
+ /** Compute paran aspects — fixed stars crossing the 4 angles (Ascendant, MC, Descendant, IC) in parallel with natal planets. */
1409
+ parans<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1410
+ /** Detail for a single Western natal planet. */
1411
+ planet<T = unknown>(input: WesternNatalInput & {
1412
+ name: string;
1413
+ }, opts?: RequestOptions): Promise<T>;
1414
+ /** Get all planet placements in the Western (tropical) birth chart — sign, degree, house, retrograde flag, and speed for all 10 planets (Sun through Pluto) plus Chiron. */
1415
+ planets<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1416
+ /** Get natal positions for trans-Neptunian objects: Eris, Sedna, Haumea, Makemake, Quaoar, Orcus, and Varuna. */
1417
+ tnos<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1418
+ /** Get positions for the eight Uranian/Hamburg school hypothetical planets: Cupido, Hades, Zeus, Kronos, Apollon, Admetos, Vulkanus, and Poseidon. */
1419
+ uranianHypotheticals<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1420
+ /** Get the Vertex, Anti-Vertex, and East Point for a natal chart. */
1421
+ vertexSet<T = unknown>(input: WesternNatalInput, opts?: RequestOptions): Promise<T>;
1422
+ }
1423
+ declare class WesternPrimaryDirections {
1424
+ private readonly _c;
1425
+ constructor(_c: ClientCore);
1426
+ /** Compute Placidus mundane primary directions — the promissor moves through the Placidus mundane house framework. */
1427
+ placidusMundane<T = unknown>(input: WesternNatalInput & {
1428
+ key?: string;
1429
+ maxAge?: number;
1430
+ converse?: boolean;
1431
+ }, opts?: RequestOptions): Promise<T>;
1432
+ /** Compute Placidus zodiacal primary directions — the oldest predictive technique in Western astrology (1° ≈ 1 year). */
1433
+ placidusZodiacal<T = unknown>(input: WesternNatalInput & {
1434
+ key?: string;
1435
+ maxAge?: number;
1436
+ converse?: boolean;
1437
+ }, opts?: RequestOptions): Promise<T>;
1438
+ /** Compute Regiomontanus primary directions — uses equatorial Right Ascension arc, the simplest and fastest calculation method. */
1439
+ regiomontanus<T = unknown>(input: WesternNatalInput & {
1440
+ key?: string;
1441
+ maxAge?: number;
1442
+ converse?: boolean;
1443
+ }, opts?: RequestOptions): Promise<T>;
1444
+ }
1445
+ declare class WesternProfections {
1446
+ private readonly _c;
1447
+ constructor(_c: ClientCore);
1448
+ /** Annual profections (Hellenistic time-lord); Ascendant advances one sign per year. */
1449
+ annual<T = unknown>(input: {
1450
+ birthDate: string;
1451
+ ascSign: string;
1452
+ refDate?: string;
1453
+ }, opts?: RequestOptions): Promise<T>;
1454
+ /** Compute the daily profection drill-down — the most granular level of the profection system. */
1455
+ daily<T = unknown>(input: {
1456
+ birthDate: string;
1457
+ refDate?: string;
1458
+ ascSign: string;
1459
+ }, opts?: RequestOptions): Promise<T>;
1460
+ /** Compute the monthly profection sub-period — which house and lord are activated this month within the annual profection cycle. */
1461
+ monthly<T = unknown>(input: {
1462
+ birthDate: string;
1463
+ refDate?: string;
1464
+ ascSign: string;
1465
+ }, opts?: RequestOptions): Promise<T>;
1466
+ }
1467
+ declare class WesternProgressions {
1468
+ private readonly _c;
1469
+ constructor(_c: ClientCore);
1470
+ /** Get secondary progressed planet aspects to natal planets — the slow symbolic evolution of the birth chart over time. */
1471
+ aspectsToNatal<T = unknown>(input: WesternNatalInput & {
1472
+ ageInYears: number;
1473
+ }, opts?: RequestOptions): Promise<T>;
1474
+ /** 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). */
1475
+ lunation<T = unknown>(input: WesternNatalInput & {
1476
+ ageInYears: number;
1477
+ }, opts?: RequestOptions): Promise<T>;
1478
+ /** Secondary progressed planetary positions at an age. */
1479
+ planets<T = unknown>(input: WesternNatalInput & {
1480
+ ageInYears: number;
1481
+ }, opts?: RequestOptions): Promise<T>;
1482
+ }
1483
+ declare class WesternReturns {
1484
+ private readonly _c;
1485
+ constructor(_c: ClientCore);
1486
+ /** Compute the Lunar Return chart — the chart for the exact moment the transiting Moon returns to its natal degree (~every 27.3 days). */
1487
+ lunar<T = unknown>(input: WesternNatalInput & {
1488
+ from: string;
1489
+ }, opts?: RequestOptions): Promise<T>;
1490
+ /** Get the aspects formed between planets in the lunar return chart. */
1491
+ lunarAspects<T = unknown>(input: WesternNatalInput & {
1492
+ from: string;
1493
+ }, opts?: RequestOptions): Promise<T>;
1494
+ /** Solar Return chart for a year. */
1495
+ solar<T = unknown>(input: WesternNatalInput & {
1496
+ returnYear: number;
1497
+ }, opts?: RequestOptions): Promise<T>;
1498
+ /** Get the aspects formed between planets in the solar return chart — shows which planets are strongly configured in the return year. */
1499
+ solarAspects<T = unknown>(input: WesternNatalInput & {
1500
+ returnYear: number;
1501
+ }, opts?: RequestOptions): Promise<T>;
1502
+ /** Get the exact Julian Day (JD) and calendar datetime of the Western (tropical) solar return for a given year — the precise moment the Sun returns to its natal tropical longitude. */
1503
+ solarExactJd<T = unknown>(input: WesternNatalInput & {
1504
+ year: number;
1505
+ }, opts?: RequestOptions): Promise<T>;
1506
+ }
1507
+ declare class WesternSolarArc {
1508
+ private readonly _c;
1509
+ constructor(_c: ClientCore);
1510
+ /** Get solar arc directed planet aspects to natal planets — a predictive technique where all planets advance at the rate of the Sun (~1°/year). */
1511
+ aspectsToNatal<T = unknown>(input: WesternNatalInput & {
1512
+ ageInYears: number;
1513
+ }, opts?: RequestOptions): Promise<T>;
1514
+ /** Solar Arc directed planetary positions at an age. */
1515
+ planets<T = unknown>(input: WesternNatalInput & {
1516
+ ageInYears: number;
1517
+ }, opts?: RequestOptions): Promise<T>;
1518
+ }
1519
+ declare class WesternSynastry {
1520
+ private readonly _c;
1521
+ constructor(_c: ClientCore);
1522
+ /** Cross-chart synastry aspects between two charts. */
1523
+ aspects<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1524
+ /** Get the full N×M synastry aspect grid between two natal charts — every planet in chart A aspecting every planet in chart B. */
1525
+ grid<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1526
+ /** Synastry compatibility score and breakdown. */
1527
+ score<T = unknown>(input: TwoPersonInput, opts?: RequestOptions): Promise<T>;
1528
+ }
1529
+ declare class WesternTransits {
1530
+ private readonly _c;
1531
+ constructor(_c: ClientCore);
1532
+ /** Get a day-by-day calendar of transiting planet aspects to a natal chart over a date range (up to 30 days). */
1533
+ calendar<T = unknown>(input: BirthInput & VedicMomentSettings & {
1534
+ from: string;
1535
+ to: string;
1536
+ }, opts?: RequestOptions): Promise<T>;
1537
+ /** Find the exact moment a transiting planet will aspect a natal planet — useful for precise transit timing. */
1538
+ exact<T = unknown>(input: BirthInput & VedicMomentSettings & {
1539
+ transitPlanet: string;
1540
+ natalPlanet: string;
1541
+ aspect: string;
1542
+ from: string;
1543
+ to: string;
1544
+ }, opts?: RequestOptions): Promise<T>;
1545
+ /** Current tropical planetary positions for transit analysis. */
1546
+ positions<T = unknown>(input: WesternMomentInput, opts?: RequestOptions): Promise<T>;
1547
+ /** All current transiting aspects to natal planets. */
1548
+ toNatal<T = unknown>(input: NatalTransitInput & VedicMomentSettings, opts?: RequestOptions): Promise<T>;
1549
+ }
1550
+ declare class WesternZodiacalReleasing {
1551
+ private readonly _c;
1552
+ constructor(_c: ClientCore);
1553
+ /** Zodiacal Releasing periods from the Lot of Fortune. */
1554
+ fortune<T = unknown>(input: {
1555
+ birthDate: string;
1556
+ lotSign: string;
1557
+ refDate?: string;
1558
+ }, opts?: RequestOptions): Promise<T>;
1559
+ /** Compute Zodiacal Releasing from the Lot of Spirit — indicates career and achievement periods. */
1560
+ spirit<T = unknown>(input: {
1561
+ birthDate: string;
1562
+ refDate?: string;
1563
+ lotSign: string;
1564
+ }, opts?: RequestOptions): Promise<T>;
1565
+ }
1566
+ /** Western (tropical) astrology endpoints. */
1567
+ declare class Western {
1568
+ private readonly _c;
1569
+ readonly astrocartography: WesternAstrocartography;
1570
+ readonly compatibility: WesternCompatibility;
1571
+ readonly composite: WesternComposite;
1572
+ readonly davison: WesternDavison;
1573
+ readonly dignities: WesternDignities;
1574
+ readonly eclipses: WesternEclipses;
1575
+ readonly heliocentric: WesternHeliocentric;
1576
+ readonly horoscope: WesternHoroscope;
1577
+ readonly interpretation: WesternInterpretation;
1578
+ readonly lunar: WesternLunar;
1579
+ readonly narrative: WesternNarrative;
1580
+ readonly natal: WesternNatal;
1581
+ readonly primaryDirections: WesternPrimaryDirections;
1582
+ readonly profections: WesternProfections;
1583
+ readonly progressions: WesternProgressions;
1584
+ readonly returns: WesternReturns;
1585
+ readonly solarArc: WesternSolarArc;
1586
+ readonly synastry: WesternSynastry;
1587
+ readonly transits: WesternTransits;
1588
+ readonly zodiacalReleasing: WesternZodiacalReleasing;
1589
+ constructor(_c: ClientCore);
1590
+ /** Firdaria planetary periods (Persian time-lord cycle). */
1591
+ firdaria<T = unknown>(input: {
1592
+ birthDate: string;
1593
+ refDate?: string;
1594
+ }, opts?: RequestOptions): Promise<T>;
1595
+ /** All planetary sign-change ingresses in a date range. */
1596
+ ingresses<T = unknown>(input: DateRangeInput, opts?: RequestOptions): Promise<T>;
1597
+ /** Retrograde station windows for a planet in a date range. */
1598
+ retrogradeWindow<T = unknown>(input: DateRangeInput & {
1599
+ planet: string;
1600
+ }, opts?: RequestOptions): Promise<T>;
1601
+ }
1602
+
1603
+ /**
1604
+ * All resource namespaces, instantiated against a {@link ClientCore}. The
1605
+ * {@link LifeAstro} client extends this so namespaces are available as
1606
+ * `client.panchang`, `client.chart`, `client.western.natal`, etc.
1607
+ */
1608
+ declare class Resources {
1609
+ readonly ashtakavarga: Ashtakavarga;
1610
+ readonly calendar: Calendar;
1611
+ readonly chart: Chart;
1612
+ readonly dasha: Dasha;
1613
+ readonly eclipses: Eclipses;
1614
+ readonly festivals: Festivals;
1615
+ readonly geo: Geo;
1616
+ readonly horoscope: Horoscope;
1617
+ readonly lalkitab: Lalkitab;
1618
+ readonly meta: Meta;
1619
+ readonly milan: Milan;
1620
+ readonly muhurta: Muhurta;
1621
+ readonly narrative: Narrative;
1622
+ readonly numerology: Numerology;
1623
+ readonly panchang: Panchang;
1624
+ readonly planetMoments: PlanetMoments;
1625
+ readonly prashna: Prashna;
1626
+ readonly remedies: Remedies;
1627
+ readonly reports: Reports;
1628
+ readonly tarot: Tarot;
1629
+ readonly transit: Transit;
1630
+ readonly varshaphal: Varshaphal;
1631
+ readonly western: Western;
1632
+ constructor(core: ClientCore);
1633
+ }
1634
+
1635
+ /**
1636
+ * The LifeAstro client: configuration, the core request method used by every
1637
+ * resource namespace, and a generic escape hatch (`request` / `get`) for
1638
+ * endpoints not yet covered by a typed method.
1639
+ */
1640
+
1641
+ /** SDK version, surfaced in the User-Agent header. */
1642
+ declare const VERSION = "0.2.0";
1643
+ interface LifeAstroOptions {
1644
+ /**
1645
+ * API key (`dv_live_...`). Falls back to the `LIFEASTRO_API_KEY` environment
1646
+ * variable when omitted. Get one at https://lifeastroapi.com/dashboard/keys
1647
+ */
1648
+ apiKey?: string;
1649
+ /** Override the API base URL (e.g. `http://localhost:8080` for local dev). */
1650
+ baseUrl?: string;
1651
+ /** Per-request timeout in milliseconds. Default 30000. */
1652
+ timeoutMs?: number;
1653
+ /** Max automatic retries on 429/5xx/network errors. Default 2. */
1654
+ maxRetries?: number;
1655
+ /** Inject a custom `fetch` implementation (older runtimes, tests, proxies). */
1656
+ fetch?: FetchLike;
1657
+ /** Extra headers sent on every request. */
1658
+ defaultHeaders?: Record<string, string>;
1659
+ }
1660
+ /** The minimal surface a resource namespace needs from the client. @internal */
1661
+ interface ClientCore {
1662
+ request<T = unknown>(path: string, query: QueryParams, opts?: RequestOptions): Promise<T>;
1663
+ }
1664
+ /**
1665
+ * The LifeAstroAPI client.
1666
+ *
1667
+ * @example
1668
+ * ```ts
1669
+ * import { LifeAstro } from "lifeastroapi";
1670
+ *
1671
+ * const client = new LifeAstro({ apiKey: "dv_live_..." });
1672
+ *
1673
+ * const tithi = await client.panchang.tithi({
1674
+ * lat: 28.6139, lon: 77.209, tz: "Asia/Kolkata",
1675
+ * });
1676
+ *
1677
+ * const planets = await client.chart.planets({
1678
+ * date: "1990-01-15", time: "10:30", tz: "Asia/Kolkata",
1679
+ * lat: 19.076, lon: 72.8777,
1680
+ * });
1681
+ * ```
1682
+ */
1683
+ declare class LifeAstro extends Resources implements ClientCore {
1684
+ #private;
1685
+ constructor(options?: LifeAstroOptions | string);
1686
+ /**
1687
+ * Generic escape hatch: call any `/v1/*` endpoint directly. Returns the
1688
+ * response payload.
1689
+ *
1690
+ * @example
1691
+ * ```ts
1692
+ * const data = await client.request("/v1/panchang/tithi", {
1693
+ * lat: 28.61, lon: 77.20, tz: "Asia/Kolkata",
1694
+ * });
1695
+ * ```
1696
+ */
1697
+ request<T = unknown>(path: string, query?: QueryParams, opts?: RequestOptions): Promise<T>;
1698
+ /** Alias for {@link LifeAstro.request}. */
1699
+ get<T = unknown>(path: string, query?: QueryParams, opts?: RequestOptions): Promise<T>;
1700
+ }
1701
+
1702
+ /**
1703
+ * Error types thrown by the LifeAstroAPI SDK.
1704
+ *
1705
+ * Every non-2xx response is mapped to a {@link LifeAstroError} (or a more
1706
+ * specific subclass) carrying the API's `code`, the HTTP `status`, and the
1707
+ * `request_id` so support can correlate. Network / timeout failures throw
1708
+ * {@link LifeAstroConnectionError}.
1709
+ */
1710
+ /** Shape of the API's error body: `{ "error": { code, message, request_id } }`. */
1711
+ interface ApiErrorBody {
1712
+ error?: {
1713
+ code?: string;
1714
+ message?: string;
1715
+ request_id?: string;
1716
+ };
1717
+ }
1718
+ interface LifeAstroErrorOptions {
1719
+ code: string;
1720
+ status: number;
1721
+ requestId?: string;
1722
+ body?: unknown;
1723
+ cause?: unknown;
1724
+ }
1725
+ /** Base class for all errors surfaced by the SDK. */
1726
+ declare class LifeAstroError extends Error {
1727
+ /** Machine-readable API error code, e.g. `insufficient_credits`. */
1728
+ readonly code: string;
1729
+ /** HTTP status code (0 for network/timeout failures). */
1730
+ readonly status: number;
1731
+ /** API request id, when present — quote this to support. */
1732
+ readonly requestId?: string;
1733
+ /** Raw parsed response body, when available. */
1734
+ readonly body?: unknown;
1735
+ constructor(message: string, opts: LifeAstroErrorOptions);
1736
+ }
1737
+ /** 400 — a query parameter was missing, malformed, or out of range. */
1738
+ declare class BadRequestError extends LifeAstroError {
1739
+ }
1740
+ /** 401 — missing or invalid API key. */
1741
+ declare class AuthenticationError extends LifeAstroError {
1742
+ }
1743
+ /** 402 — out of credits / trial exhausted / payment required. */
1744
+ declare class PaymentRequiredError extends LifeAstroError {
1745
+ }
1746
+ /** 403 — key valid but not permitted (tier, IP allow-list, suspended). */
1747
+ declare class PermissionError extends LifeAstroError {
1748
+ }
1749
+ /** 404 — unknown path or sub-resource. */
1750
+ declare class NotFoundError extends LifeAstroError {
1751
+ }
1752
+ /** 429 — rate limit or daily quota exceeded. `retryAfter` is in seconds. */
1753
+ declare class RateLimitError extends LifeAstroError {
1754
+ readonly retryAfter?: number;
1755
+ constructor(message: string, opts: LifeAstroErrorOptions & {
1756
+ retryAfter?: number;
1757
+ });
1758
+ }
1759
+ /** 5xx — server-side failure. */
1760
+ declare class ServerError extends LifeAstroError {
1761
+ }
1762
+ /** Network failure, DNS error, or request timeout (no HTTP status). */
1763
+ declare class LifeAstroConnectionError extends LifeAstroError {
1764
+ constructor(message: string, opts?: {
1765
+ cause?: unknown;
1766
+ code?: string;
1767
+ });
1768
+ }
1769
+
1770
+ /**
1771
+ * lifeastroapi — official Node.js / TypeScript SDK for LifeAstroAPI.
1772
+ *
1773
+ * @packageDocumentation
1774
+ */
1775
+
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 };