@roxyapi/sdk 1.2.48 → 1.2.50

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/factory.cjs CHANGED
@@ -1436,9 +1436,9 @@ var VedicAstrology = class extends HeyApiClient {
1436
1436
  });
1437
1437
  }
1438
1438
  /**
1439
- * Get current Mahadasha, Antardasha, Pratyantardasha - Dasha Calculator API
1439
+ * Get current Mahadasha, Antardasha, Pratyantardasha, Sookshma - Dasha Calculator API
1440
1440
  *
1441
- * Calculate current Vimshottari Dasha periods (Mahadasha, Antardasha, Pratyantardasha) with remaining time. Accurate dasha calculator API for life phase prediction and planetary period analysis. Returns dasha timeline with start/end dates for each period. Essential for understanding current planetary influences, dasha transitions, and timing events in Vedic astrology. 120-year dasha system based on moon nakshatra at birth.
1441
+ * Calculate all four running Vimshottari Dasha levels (Mahadasha, Antardasha, Pratyantardasha, Sookshma) with remaining time in each. Accurate dasha calculator API for life phase prediction and planetary period analysis. Returns the dasha timeline with start/end dates for every level, ready for a current DBA readout. Essential for understanding current planetary influences, dasha transitions, and timing events in Vedic astrology. 120-year dasha system based on moon nakshatra at birth, with selectable Lahiri or KP ayanamsa.
1442
1442
  */
1443
1443
  getCurrentDasha(options) {
1444
1444
  return (options?.client ?? this.client).post({
@@ -1483,6 +1483,38 @@ var VedicAstrology = class extends HeyApiClient {
1483
1483
  }
1484
1484
  });
1485
1485
  }
1486
+ /**
1487
+ * Get all Pratyantardashas (antara periods) for a Mahadasha and Antardasha
1488
+ *
1489
+ * Pratyantardasha calculator API. Returns the 9 Pratyantardasha (antara) periods inside a chosen Antardasha, the third level of the Vimshottari dasha hierarchy. Use it to drill from a Mahadasha into month level timing for event prediction, muhurta selection, and dasha timeline UIs. Each period is proportional to the Vimshottari years of its lord.
1490
+ */
1491
+ getPratyantardashas(options) {
1492
+ return (options.client ?? this.client).post({
1493
+ security: [{ name: "X-API-Key", type: "apiKey" }],
1494
+ url: "/vedic-astrology/dasha/sub/{mahadasha}/{antardasha}",
1495
+ ...options,
1496
+ headers: {
1497
+ "Content-Type": "application/json",
1498
+ ...options.headers
1499
+ }
1500
+ });
1501
+ }
1502
+ /**
1503
+ * Get all Sookshma dashas for a Mahadasha, Antardasha and Pratyantardasha
1504
+ *
1505
+ * Sookshma dasha API. Returns the 9 Sookshma periods inside a chosen Pratyantardasha, the fourth and finest level of the Vimshottari dasha hierarchy. Completes a full vimshottari drill down from the 120-year cycle to day level timing, typically 3 to 30 days per period. Built for dasha drill down tables, current DBA readouts, and precise event timing in Vedic astrology software.
1506
+ */
1507
+ getSookshmaDashas(options) {
1508
+ return (options.client ?? this.client).post({
1509
+ security: [{ name: "X-API-Key", type: "apiKey" }],
1510
+ url: "/vedic-astrology/dasha/sub/{mahadasha}/{antardasha}/{pratyantardasha}",
1511
+ ...options,
1512
+ headers: {
1513
+ "Content-Type": "application/json",
1514
+ ...options.headers
1515
+ }
1516
+ });
1517
+ }
1486
1518
  /**
1487
1519
  * Get basic Panchang - Tithi Nakshatra Yoga Karana Calculator
1488
1520
  *
@@ -2000,16 +2032,16 @@ var VedicAstrology = class extends HeyApiClient {
2000
2032
  });
2001
2033
  }
2002
2034
  };
2003
- var Numerology = class extends HeyApiClient {
2035
+ var Forecast = class extends HeyApiClient {
2004
2036
  /**
2005
- * Calculate Life Path number - Most important numerology calculation
2037
+ * Cross-domain forecast timeline - Transits, ingresses, stations, dasha changes, critical days
2006
2038
  *
2007
- * Calculate your Life Path number from your birth date using Pythagorean numerology. This is the most significant number in your numerology chart, revealing your life purpose, natural talents, and destiny path. Automatically detects Master Numbers (11, 22, 33) and Karmic Debt numbers (13, 14, 16, 19). Returns comprehensive interpretation including personality traits, strengths, challenges, career guidance, relationship compatibility, and spiritual insights. Perfect for numerology apps, birth chart calculators, life purpose discovery tools, personal development platforms, and astrology services. Get detailed 300-500 word meanings for all numbers 1-9, 11, 22, and 33.
2039
+ * Build one time-ordered forecast for a single birth subject by merging upcoming events across three domains: western transit-to-natal aspects, sign ingresses, retrograde stations, eclipses, and new and full moons; biorhythm critical days; and vedic Vimshottari mahadasha, antardasha, and pratyantardasha boundaries. The window is clamped to 90 days and events are capped and scored by significance. Built for what-is-coming dashboards, daily and weekly forecast feeds, and timing tools.
2008
2040
  */
2009
- calculateLifePath(options) {
2041
+ generateTimeline(options) {
2010
2042
  return (options?.client ?? this.client).post({
2011
2043
  security: [{ name: "X-API-Key", type: "apiKey" }],
2012
- url: "/numerology/life-path",
2044
+ url: "/forecast/timeline",
2013
2045
  ...options,
2014
2046
  headers: {
2015
2047
  "Content-Type": "application/json",
@@ -2018,14 +2050,14 @@ var Numerology = class extends HeyApiClient {
2018
2050
  });
2019
2051
  }
2020
2052
  /**
2021
- * Calculate Expression number - Natural talents and life goals
2053
+ * Western astrology forecast - aspects, ingresses, stations, eclipses, moon phases
2022
2054
  *
2023
- * Calculate your Expression (Destiny) number from your full birth name using Pythagorean numerology. This number reveals your natural talents, abilities, and life goals. It shows what you came here to do and what tools you have to accomplish your life purpose. Returns comprehensive interpretation including personality traits, career paths, relationship dynamics, and spiritual insights. Automatically detects Master Numbers (11, 22, 33). Perfect for name numerology apps, career guidance tools, personal development platforms, and talent assessment services. Get detailed 300-500 word meanings for all numbers 1-9, 11, 22, and 33.
2055
+ * Forecast the western astrology events for a single birth chart over a window up to 90 days: every transit-to-natal major aspect refined to its exact instant, every transiting planet sign ingress, every retrograde or direct station, every solar and lunar eclipse, and every New and Full Moon. Returns a time-ordered, significance-scored timeline. Built for astrology forecast feeds, transit alerts, and timing tools.
2024
2056
  */
2025
- calculateExpression(options) {
2057
+ forecastTransits(options) {
2026
2058
  return (options?.client ?? this.client).post({
2027
2059
  security: [{ name: "X-API-Key", type: "apiKey" }],
2028
- url: "/numerology/expression",
2060
+ url: "/forecast/transits",
2029
2061
  ...options,
2030
2062
  headers: {
2031
2063
  "Content-Type": "application/json",
@@ -2034,14 +2066,14 @@ var Numerology = class extends HeyApiClient {
2034
2066
  });
2035
2067
  }
2036
2068
  /**
2037
- * Calculate Bridge Numbers - Harmonize different aspects of personality
2069
+ * Significant dates - High-significance cross-domain forecast highlights
2038
2070
  *
2039
- * Calculate three Bridge Numbers that reveal the adjustments needed to create harmony between different aspects of your numerology profile. Bridge Numbers are the absolute difference between pairs of core numbers: Life Path and Expression, Expression and Personality, Expression and Soul Urge. A Bridge of 0 means the two aspects are already aligned. Higher bridges (1 to 8) indicate greater tension and provide specific guidance on what changes to make. Bridge Numbers are essential for personal development, coaching applications, self-improvement platforms, and AI-powered personality analysis tools. Requires both a full birth name and birth date to calculate all four core numbers (Life Path, Expression, Soul Urge, Personality) internally before deriving the bridges.
2071
+ * Return only the high-significance dates from the merged cross-domain forecast for a single birth subject: the rare outer-planet exact transit aspects, slow-planet sign ingresses, retrograde stations, and Vimshottari mahadasha and antardasha changes that mark genuine turning points. Defaults to a significance floor of 70 so the response is a short list of the most meaningful upcoming dates. Built for what-is-coming highlights, timing alerts, and at-a-glance forecast strips.
2040
2072
  */
2041
- calculateBridgeNumbers(options) {
2073
+ findSignificantDates(options) {
2042
2074
  return (options?.client ?? this.client).post({
2043
2075
  security: [{ name: "X-API-Key", type: "apiKey" }],
2044
- url: "/numerology/bridge",
2076
+ url: "/forecast/significant-dates",
2045
2077
  ...options,
2046
2078
  headers: {
2047
2079
  "Content-Type": "application/json",
@@ -2050,14 +2082,14 @@ var Numerology = class extends HeyApiClient {
2050
2082
  });
2051
2083
  }
2052
2084
  /**
2053
- * Calculate Soul Urge number - Inner motivations and desires
2085
+ * Forecast digest - Pre-summarized next 24h, 7d, 30d, and 90d rollups
2054
2086
  *
2055
- * Calculate your Soul Urge (Heart Desire) number from the vowels in your birth name using Pythagorean numerology. This number reveals your innermost desires, motivations, and what your soul truly wants to experience. It shows what drives you from within, your emotional needs, and what brings you fulfillment. Returns comprehensive interpretation including personality traits, emotional needs, relationship desires, and spiritual longings. Automatically detects Master Numbers (11, 22, 33). Perfect for self-discovery apps, emotional intelligence tools, relationship counseling platforms, and personal development services. Get detailed 300-500 word meanings for all numbers 1-9, 11, 22, and 33.
2087
+ * Roll the cross-domain forecast for a single birth subject into four pre-summarized windows: the next 24 hours, 7 days, 30 days, and 90 days from the start date. Each window returns its event count, a per-domain count breakdown, a per-type count breakdown, and the top highest-significance events. Built for a glanceable what-is-coming strip so a caller can render the upcoming highlights without scanning the full event list.
2056
2088
  */
2057
- calculateSoulUrge(options) {
2089
+ generateDigest(options) {
2058
2090
  return (options?.client ?? this.client).post({
2059
2091
  security: [{ name: "X-API-Key", type: "apiKey" }],
2060
- url: "/numerology/soul-urge",
2092
+ url: "/forecast/digest",
2061
2093
  ...options,
2062
2094
  headers: {
2063
2095
  "Content-Type": "application/json",
@@ -2066,14 +2098,14 @@ var Numerology = class extends HeyApiClient {
2066
2098
  });
2067
2099
  }
2068
2100
  /**
2069
- * Calculate Personality number - How others perceive you
2101
+ * Solar return chart - Annual birthday forecast chart for a single subject
2070
2102
  *
2071
- * Calculate your Personality number from the consonants in your birth name using Pythagorean numerology. This number reveals how others perceive you, your outer personality, and first impressions you make. It represents the mask you show the world and your social persona. Returns comprehensive interpretation including public image, social dynamics, professional presence, and relationship first impressions. Automatically detects Master Numbers (11, 22, 33). Perfect for personal branding apps, social skills training, professional development platforms, and communication coaching services. Get detailed 300-500 word meanings for all numbers 1-9, 11, 22, and 33.
2103
+ * Cast the solar return chart for one subject and year: the chart erected for the exact moment the transiting Sun returns to its natal ecliptic longitude, the foundational technique for annual astrological forecasting. Returns the full tropical chart with planetary positions, house cusps, aspects, Ascendant, and Midheaven. Location-sensitive: pass the birthplace to anchor the chart to natal geography, or the current city for a relocated solar return where the houses and Ascendant shift to where you are on your birthday. Built for year-ahead forecast tools, birthday charts, and annual horoscope features.
2072
2104
  */
2073
- calculatePersonality(options) {
2105
+ forecastSolarReturn(options) {
2074
2106
  return (options?.client ?? this.client).post({
2075
2107
  security: [{ name: "X-API-Key", type: "apiKey" }],
2076
- url: "/numerology/personality",
2108
+ url: "/forecast/solar-return",
2077
2109
  ...options,
2078
2110
  headers: {
2079
2111
  "Content-Type": "application/json",
@@ -2081,15 +2113,17 @@ var Numerology = class extends HeyApiClient {
2081
2113
  }
2082
2114
  });
2083
2115
  }
2116
+ };
2117
+ var HumanDesign = class extends HeyApiClient {
2084
2118
  /**
2085
- * Calculate Birth Day number - Special talents from day of birth
2119
+ * Generate full Human Design bodygraph - Type, authority, profile, centers, channels, gates
2086
2120
  *
2087
- * Calculate your Birth Day number from the day you were born (1-31) using Pythagorean numerology. This number reveals special talents and abilities you possess from birth. It shows natural gifts that can help you achieve your life purpose. Returns comprehensive interpretation including innate talents, natural abilities, career advantages, and how to leverage your special gifts. Automatically detects Master Numbers (11, 22) and reduces double-digit days. Perfect for talent discovery apps, career counseling platforms, personal development services, and skill assessment tools. Get detailed 300-500 word meanings for all numbers 1-9, 11, and 22.
2121
+ * Generate a complete Human Design bodygraph from a birth date, time, and timezone. Returns the energy type, strategy, inner authority, signature, not-self theme, profile, definition, incarnation cross, all nine centers with defined state and active gates, the defined channels, and all 26 planetary activations across the Personality and Design sides. The single endpoint for a full chart in one call, built for Human Design apps, readings, and coaching tools.
2088
2122
  */
2089
- calculateBirthDay(options) {
2123
+ generateBodygraph(options) {
2090
2124
  return (options?.client ?? this.client).post({
2091
2125
  security: [{ name: "X-API-Key", type: "apiKey" }],
2092
- url: "/numerology/birth-day",
2126
+ url: "/human-design/bodygraph",
2093
2127
  ...options,
2094
2128
  headers: {
2095
2129
  "Content-Type": "application/json",
@@ -2098,14 +2132,14 @@ var Numerology = class extends HeyApiClient {
2098
2132
  });
2099
2133
  }
2100
2134
  /**
2101
- * Calculate Maturity number - Who you become in later life
2135
+ * Calculate Human Design connection chart - Two-person composite bodygraph compatibility
2102
2136
  *
2103
- * Calculate your Maturity (Realization) number by adding Life Path and Expression numbers using Pythagorean numerology. This number reveals who you become in the second half of life, typically manifesting after age 35-40. It shows the ultimate goal of personal development and mature self-expression. Returns comprehensive interpretation including life transformation, mature personality, later-life purpose, and wisdom development. Automatically detects Master Numbers (11, 22, 33). Perfect for life coaching apps, midlife guidance platforms, personal development services, and aging wisdom tools. Get detailed 300-500 word meanings for all numbers 1-9, 11, 22, and 33.
2137
+ * Calculate a Human Design connection chart by overlaying two bodygraphs. For each of the 36 channels the dynamic between the two people is classified as electromagnetic, dominance, compromise, or companionship, the four mechanics of how two designs meet. Also returns the nine centers as defined or open in the combined bodygraph with which person defines each, the combined definition, and a count of each dynamic. Built for relationship, dating, and coaching tools.
2104
2138
  */
2105
- calculateMaturity(options) {
2139
+ calculateConnection(options) {
2106
2140
  return (options?.client ?? this.client).post({
2107
2141
  security: [{ name: "X-API-Key", type: "apiKey" }],
2108
- url: "/numerology/maturity",
2142
+ url: "/human-design/connection",
2109
2143
  ...options,
2110
2144
  headers: {
2111
2145
  "Content-Type": "application/json",
@@ -2114,14 +2148,14 @@ var Numerology = class extends HeyApiClient {
2114
2148
  });
2115
2149
  }
2116
2150
  /**
2117
- * Analyze Karmic Lessons - Life lessons from missing numbers
2151
+ * Calculate Human Design Penta - Small-group BG5 operating system for three to five people
2118
2152
  *
2119
- * Analyze your Karmic Lessons from your birth name using Pythagorean numerology. Karmic lessons are indicated by numbers missing from your name (numbers 1-9 that do not appear). These represent challenges you came to learn and skills you need to develop in this lifetime. Returns comprehensive analysis including missing numbers, specific lessons for each, challenges to overcome, and practical guidance for development. Perfect for spiritual growth apps, personal development platforms, life coaching services, and self-improvement tools. Get detailed lesson descriptions, development strategies, and practical exercises for each missing number.
2153
+ * Calculate the Human Design Penta (BG5, Base Group 5) for a small group of three to five people. The Penta is a trans-auric form built from a fixed set of six channels running only between the Sacral, the G Center, and the Throat. It reports which of the twelve Penta gates are filled and by whom, which of the six channels are defined Strengths, the upper leadership channels versus the lower generative channels, the 2/14 material core, and the functional gaps where no member supplies a role. Built for team, family, and group analysis tools. Below three people no Penta forms and above five a second Penta emerges, so the group size must be three to five.
2120
2154
  */
2121
- analyzeKarmicLessons(options) {
2155
+ calculatePenta(options) {
2122
2156
  return (options?.client ?? this.client).post({
2123
2157
  security: [{ name: "X-API-Key", type: "apiKey" }],
2124
- url: "/numerology/karmic-lessons",
2158
+ url: "/human-design/penta",
2125
2159
  ...options,
2126
2160
  headers: {
2127
2161
  "Content-Type": "application/json",
@@ -2130,14 +2164,14 @@ var Numerology = class extends HeyApiClient {
2130
2164
  });
2131
2165
  }
2132
2166
  /**
2133
- * Detect Karmic Debt numbers - Past life challenges (13, 14, 16, 19)
2167
+ * Generate Human Design transit overlay - Current planetary activations on a natal bodygraph
2134
2168
  *
2135
- * Check for Karmic Debt numbers (13, 14, 16, 19) in Life Path, Expression, Soul Urge, or Personality calculations using Pythagorean numerology. Karmic debt indicates challenges carried from past lives that must be resolved in this lifetime. These numbers appear during reduction and represent specific lessons and tests. Returns comprehensive analysis including debt descriptions, challenges to overcome, and resolution guidance. Perfect for spiritual growth apps, karmic astrology platforms, past life exploration services, and personal transformation tools. Get detailed meanings for all four karmic debt numbers with practical resolution strategies.
2169
+ * Overlay the current or any given planetary positions on a natal Human Design bodygraph to see which channels the transit temporarily completes. Returns the 13 transiting body activations with gate and line, the channels the transit completes beyond the natal definition split into personal channels where the transit supplies the partner gate of a natal gate and educational channels where the transit supplies both gates, the natally open centers those channels temporarily define, and a short factual summary. A transit is a single moment, so there is no Design side. When date and time are omitted the overlay is computed for now in UTC. Built for daily Human Design apps, transit widgets, and notification tools.
2136
2170
  */
2137
- checkKarmicDebt(options) {
2171
+ generateTransit(options) {
2138
2172
  return (options?.client ?? this.client).post({
2139
2173
  security: [{ name: "X-API-Key", type: "apiKey" }],
2140
- url: "/numerology/karmic-debt",
2174
+ url: "/human-design/transit",
2141
2175
  ...options,
2142
2176
  headers: {
2143
2177
  "Content-Type": "application/json",
@@ -2146,14 +2180,14 @@ var Numerology = class extends HeyApiClient {
2146
2180
  });
2147
2181
  }
2148
2182
  /**
2149
- * Calculate Personal Day - Daily personalized numerology forecast
2183
+ * Calculate Human Design type, authority and profile
2150
2184
  *
2151
- * Calculate your Personal Day number from birth month, day, and a target date. Personal Day is the most granular cycle in Pythagorean numerology, revealing the specific energy and theme for a single calendar day personalized to you. Unlike generic daily numbers, this is based on YOUR birth data combined with the calendar date. Returns the daily theme, actionable guidance, and parent month and year context. Perfect for daily push notifications, morning briefings, calendar widget integrations, daily content generation, and life coaching tools.
2185
+ * Calculate the core Human Design identity from a birth moment: the energy type, the aura strategy, the inner authority, the signature and not-self themes, and the profile. The fast lookup for type-and-authority features without the full bodygraph payload. Verified against NASA JPL Horizons positions.
2152
2186
  */
2153
- calculatePersonalDay(options) {
2187
+ calculateType(options) {
2154
2188
  return (options?.client ?? this.client).post({
2155
2189
  security: [{ name: "X-API-Key", type: "apiKey" }],
2156
- url: "/numerology/personal-day",
2190
+ url: "/human-design/type",
2157
2191
  ...options,
2158
2192
  headers: {
2159
2193
  "Content-Type": "application/json",
@@ -2162,14 +2196,14 @@ var Numerology = class extends HeyApiClient {
2162
2196
  });
2163
2197
  }
2164
2198
  /**
2165
- * Calculate Personal Month - Monthly numerology forecast
2199
+ * Calculate the 26 Human Design gate activations
2166
2200
  *
2167
- * Calculate your Personal Month number from birth month, day, and a target year and month. Personal Month reveals the specific theme and energy influencing each calendar month within your Personal Year cycle. Returns the monthly theme, practical focus guidance, and the parent Personal Year context. Perfect for monthly forecast features, push notification content, calendar integrations, editorial monthly columns, and life coaching tools.
2201
+ * Calculate the 26 gate activations for a birth moment, split into the 13 conscious Personality activations at birth and the 13 unconscious Design activations 88 degrees of solar arc earlier. Each activation reports the planet, gate, line, gate keynote, and the matching I-Ching hexagram. Built for activation columns and detailed chart views.
2168
2202
  */
2169
- calculatePersonalMonth(options) {
2203
+ calculateGates(options) {
2170
2204
  return (options?.client ?? this.client).post({
2171
2205
  security: [{ name: "X-API-Key", type: "apiKey" }],
2172
- url: "/numerology/personal-month",
2206
+ url: "/human-design/gates",
2173
2207
  ...options,
2174
2208
  headers: {
2175
2209
  "Content-Type": "application/json",
@@ -2178,30 +2212,26 @@ var Numerology = class extends HeyApiClient {
2178
2212
  });
2179
2213
  }
2180
2214
  /**
2181
- * Calculate Personal Year - Annual cycle and forecast for current year
2215
+ * Look up a Human Design gate by number
2182
2216
  *
2183
- * Calculate your Personal Year number from your birth month, day, and current year using Pythagorean numerology. Personal Year runs in 9-year cycles (1-9) and reveals the theme, opportunities, and challenges for the current year. Each year has a specific energy and lessons. Returns comprehensive annual forecast including year theme, opportunities, challenges, and actionable advice. Perfect for yearly planning apps, life coaching platforms, astrology services, and personal development tools. Get detailed forecasts for all 9 Personal Year cycles with practical guidance.
2217
+ * Look up the static reference data for a Human Design gate by its number from 1 to 64: the gate keynote name, the center it sits in, the matching I-Ching hexagram, and the gates that form a channel with it. A pure reference endpoint with no birth data required.
2184
2218
  */
2185
- calculatePersonalYear(options) {
2186
- return (options?.client ?? this.client).post({
2219
+ getGate(options) {
2220
+ return (options.client ?? this.client).get({
2187
2221
  security: [{ name: "X-API-Key", type: "apiKey" }],
2188
- url: "/numerology/personal-year",
2189
- ...options,
2190
- headers: {
2191
- "Content-Type": "application/json",
2192
- ...options?.headers
2193
- }
2222
+ url: "/human-design/gates/{number}",
2223
+ ...options
2194
2224
  });
2195
2225
  }
2196
2226
  /**
2197
- * Calculate Compatibility - Relationship dynamics between two people
2227
+ * Calculate the defined Human Design channels
2198
2228
  *
2199
- * Calculate numerology compatibility between two people using Pythagorean numerology. Accepts two input modes per person: pre-calculated Life Path, Expression, and Soul Urge numbers, or raw name and birthdate for automatic calculation. You can mix modes across persons (e.g. numbers for person1, raw inputs for person2). Provides comprehensive relationship analysis with overall compatibility score (0-100), individual aspect compatibility (Life Path 50% weight, Expression 30%, Soul Urge 20%), relationship strengths, challenges, and practical advice. Uses detailed compatibility matrix for all number combinations. Perfect for dating apps, relationship counseling platforms, matchmaking services, and compatibility tools. Get actionable insights for improving relationship dynamics.
2229
+ * Calculate the defined channels for a birth moment. A channel is defined when both of its gates are activated, and it wires together the two centers it connects. Returns each defined channel with its gates, name, circuit family, and connected centers, plus the full set of centers those channels define. Built for bodygraph rendering and definition analysis.
2200
2230
  */
2201
- calculateNumCompatibility(options) {
2231
+ calculateChannels(options) {
2202
2232
  return (options?.client ?? this.client).post({
2203
2233
  security: [{ name: "X-API-Key", type: "apiKey" }],
2204
- url: "/numerology/compatibility",
2234
+ url: "/human-design/channels",
2205
2235
  ...options,
2206
2236
  headers: {
2207
2237
  "Content-Type": "application/json",
@@ -2210,14 +2240,14 @@ var Numerology = class extends HeyApiClient {
2210
2240
  });
2211
2241
  }
2212
2242
  /**
2213
- * Generate Complete Numerology Chart - Full profile analysis
2243
+ * Calculate the nine Human Design centers
2214
2244
  *
2215
- * Generate a comprehensive numerology chart combining all major calculations: Life Path, Expression, Soul Urge, Personality, Birth Day, Maturity, Karmic Lessons, Karmic Debt, and Personal Year. This single endpoint provides everything needed for a full numerology reading. Returns detailed interpretations for all numbers, karmic analysis, yearly forecast, and holistic summary. Perfect for numerology apps, complete reading services, birth chart generators, and comprehensive analysis tools. Save multiple API calls by getting the full chart in one request. Ideal for generating PDF reports or detailed user profiles.
2245
+ * Calculate the state of all nine Human Design centers for a birth moment: whether each is defined or open, whether it is a motor or an awareness center, its theme, and the active gates it holds. The data layer behind a rendered bodygraph where defined centers are colored and open centers are white.
2216
2246
  */
2217
- generateNumerologyChart(options) {
2247
+ calculateCenters(options) {
2218
2248
  return (options?.client ?? this.client).post({
2219
2249
  security: [{ name: "X-API-Key", type: "apiKey" }],
2220
- url: "/numerology/chart",
2250
+ url: "/human-design/centers",
2221
2251
  ...options,
2222
2252
  headers: {
2223
2253
  "Content-Type": "application/json",
@@ -2226,26 +2256,26 @@ var Numerology = class extends HeyApiClient {
2226
2256
  });
2227
2257
  }
2228
2258
  /**
2229
- * Get Number Meaning - Interpretation for any number 1-9, 11, 22, 33
2259
+ * Look up a Human Design center by id
2230
2260
  *
2231
- * Get the complete meaning and interpretation for any numerology number (1-9, 11, 22, 33) using Pythagorean numerology. Returns comprehensive description including archetype title, keywords, personality traits, strengths, weaknesses, career guidance, relationship dynamics, and spiritual insights. Master numbers (11, 22, 33) include amplified meanings with their reduced base number. Perfect for numerology reference tools, educational apps, quick lookups, and building custom numerology calculators. Get detailed 300-500 word expert-written meanings for all 12 valid numerology numbers.
2261
+ * Look up the static reference data for one of the nine Human Design centers by its id: the display name, whether it is a motor or awareness center, and what it means both defined and undefined. A pure reference endpoint with no birth data required.
2232
2262
  */
2233
- getNumberMeaning(options) {
2263
+ getCenter(options) {
2234
2264
  return (options.client ?? this.client).get({
2235
2265
  security: [{ name: "X-API-Key", type: "apiKey" }],
2236
- url: "/numerology/meanings/{number}",
2266
+ url: "/human-design/centers/{id}",
2237
2267
  ...options
2238
2268
  });
2239
2269
  }
2240
2270
  /**
2241
- * Get daily numerology number - Number of the Day with interpretation
2271
+ * Calculate the Human Design profile and line keynotes
2242
2272
  *
2243
- * Receive a daily numerology number (1-9, 11, 22, 33) for guidance and reflection. Uses seeded randomness so the same seed gets the same number on the same date, perfect for "Number of the Day" features in numerology apps, wellness platforms, and daily guidance tools. Returns the number with full interpretation including archetype, keywords, strengths, challenges, career, relationships, and spiritual insights. Ideal for daily push notifications, morning briefings, and personalized numerology experiences.
2273
+ * Calculate the Human Design profile for a birth moment: the conscious Personality Sun line over the unconscious Design Sun line, with the keynote for each. The profile is the geometry of the life role, for example 5/1 the Heretic Investigator. Verified against NASA JPL Horizons positions.
2244
2274
  */
2245
- getDailyNumber(options) {
2275
+ calculateProfile(options) {
2246
2276
  return (options?.client ?? this.client).post({
2247
2277
  security: [{ name: "X-API-Key", type: "apiKey" }],
2248
- url: "/numerology/daily",
2278
+ url: "/human-design/profile",
2249
2279
  ...options,
2250
2280
  headers: {
2251
2281
  "Content-Type": "application/json",
@@ -2254,14 +2284,14 @@ var Numerology = class extends HeyApiClient {
2254
2284
  });
2255
2285
  }
2256
2286
  /**
2257
- * Chaldean numerology name reading - Destiny, compound number, planetary ruler
2287
+ * Calculate Human Design Variables - The four arrows and Color, Tone, Base substructure
2258
2288
  *
2259
- * Calculate a complete Chaldean numerology reading for a name. The older Chaldean system maps letters to values 1 to 8 by vibration (the number 9 is sacred and never assigned to a letter) and reads the unreduced two-digit compound number (10 to 52, also called a fadic number, defined by Cheiro) in addition to the single-digit root. Returns the Destiny or name number from all letters, the Soul Urge from vowels, and the Personality from consonants, each with its compound number, root, and Cheiro compound interpretation, plus the planetary ruler of the Destiny root and a caution flag for the karmic numbers 4 and 8. Perfect for Chaldean numerology calculators, name analysis tools, and AI numerology assistants that need both the compound and root layers in one call.
2289
+ * Calculate the four Human Design Variable arrows for a birth moment: Determination and Environment on the design side, Perspective and Motivation on the personality side. Each arrow returns its Color, Tone, and Base numbers from the hexagram-line substructure, the left or right direction set by the Tone, and the sourced Color and direction labels. This is the advanced Rave Variables and Primary Health System layer beneath Type, Strategy, Authority, and Profile. Color, Tone, and Base shift with tiny differences in birth time, so each arrow carries a confidence flag that turns false near a Color or Tone boundary, and a precise birth time is essential. Built for Human Design apps offering PHS, diet, environment, and Rave Psychology readings.
2260
2290
  */
2261
- calculateChaldean(options) {
2291
+ calculateVariables(options) {
2262
2292
  return (options?.client ?? this.client).post({
2263
2293
  security: [{ name: "X-API-Key", type: "apiKey" }],
2264
- url: "/numerology/chaldean",
2294
+ url: "/human-design/variables",
2265
2295
  ...options,
2266
2296
  headers: {
2267
2297
  "Content-Type": "application/json",
@@ -2269,27 +2299,17 @@ var Numerology = class extends HeyApiClient {
2269
2299
  }
2270
2300
  });
2271
2301
  }
2302
+ };
2303
+ var Numerology = class extends HeyApiClient {
2272
2304
  /**
2273
- * Compound number meaning - Cheiro Chaldean interpretation 10 to 52
2274
- *
2275
- * Get the classical Chaldean interpretation of a compound number (also called a fadic number) from 10 to 52, as defined by Cheiro in the Book of Numbers. Compound numbers are the unreduced two-digit numbers that reveal the hidden influence behind a name or date, beyond the single-digit root. Each returns its symbolic title (such as The Wheel of Fortune for 10, The Star of the Magi for 17, or The Crown of the Magi for 21), its nature (fortunate, unfortunate, or mixed), and a full interpretation. Numbers 33 to 52 share the meaning of a lower number in their series, returned with a sameAs pointer. Perfect for Chaldean numerology references, compound number lookups, and AI numerology tools.
2276
- */
2277
- getCompoundNumber(options) {
2278
- return (options.client ?? this.client).get({
2279
- security: [{ name: "X-API-Key", type: "apiKey" }],
2280
- url: "/numerology/compound-number/{number}",
2281
- ...options
2282
- });
2283
- }
2284
- /**
2285
- * Dual numerology - Pythagorean and Chaldean name numbers in one call
2305
+ * Calculate Life Path number - Most important numerology calculation
2286
2306
  *
2287
- * Calculate a name number in both major numerology systems at once and compare them. The Pythagorean system maps letters 1 to 9 in alphabetical order and preserves master numbers (11, 22, 33), giving the Expression or Destiny number used in modern Western numerology. The Chaldean system maps letters 1 to 8 by vibration, reads the compound number (10 to 52), and reduces to a root 1 to 9. Returns both results with their interpretations, plus an agreement flag showing whether the two systems point to the same single-digit energy. The only numerology API that returns Pythagorean and Chaldean for a name in a single request, ideal for comparison tools and AI numerology assistants.
2307
+ * Calculate your Life Path number from your birth date using Pythagorean numerology. This is the most significant number in your numerology chart, revealing your life purpose, natural talents, and destiny path. Automatically detects Master Numbers (11, 22, 33) and Karmic Debt numbers (13, 14, 16, 19). Returns comprehensive interpretation including personality traits, strengths, challenges, career guidance, relationship compatibility, and spiritual insights. Perfect for numerology apps, birth chart calculators, life purpose discovery tools, personal development platforms, and astrology services. Get detailed 300-500 word meanings for all numbers 1-9, 11, 22, and 33.
2288
2308
  */
2289
- calculateDual(options) {
2309
+ calculateLifePath(options) {
2290
2310
  return (options?.client ?? this.client).post({
2291
2311
  security: [{ name: "X-API-Key", type: "apiKey" }],
2292
- url: "/numerology/dual",
2312
+ url: "/numerology/life-path",
2293
2313
  ...options,
2294
2314
  headers: {
2295
2315
  "Content-Type": "application/json",
@@ -2298,14 +2318,14 @@ var Numerology = class extends HeyApiClient {
2298
2318
  });
2299
2319
  }
2300
2320
  /**
2301
- * Business name numerology - Chaldean brand name analysis and lucky numbers
2321
+ * Calculate Expression number - Natural talents and life goals
2302
2322
  *
2303
- * Analyze a business or brand name with Chaldean numerology, the system practitioners use for trade names. Returns the name number (compound and root), its planetary ruler, an overall business rating, the industries the number favors, and whether the compound is one of Cheiro fortunate compounds. The most favorable business roots are 1 (leadership), 3 (expansion), 5 (commerce) and 6 (beauty and hospitality); the numbers 4 and 8 carry caution as the karmic numbers of instability and heavy demand. Use it to vet a company name, compare brand options, or guide a naming decision. This is positioning guidance layered over the fundamentals of a memorable, available name, not a guarantee.
2323
+ * Calculate your Expression (Destiny) number from your full birth name using Pythagorean numerology. This number reveals your natural talents, abilities, and life goals. It shows what you came here to do and what tools you have to accomplish your life purpose. Returns comprehensive interpretation including personality traits, career paths, relationship dynamics, and spiritual insights. Automatically detects Master Numbers (11, 22, 33). Perfect for name numerology apps, career guidance tools, personal development platforms, and talent assessment services. Get detailed 300-500 word meanings for all numbers 1-9, 11, 22, and 33.
2304
2324
  */
2305
- calculateBusinessName(options) {
2325
+ calculateExpression(options) {
2306
2326
  return (options?.client ?? this.client).post({
2307
2327
  security: [{ name: "X-API-Key", type: "apiKey" }],
2308
- url: "/numerology/business-name",
2328
+ url: "/numerology/expression",
2309
2329
  ...options,
2310
2330
  headers: {
2311
2331
  "Content-Type": "application/json",
@@ -2313,57 +2333,47 @@ var Numerology = class extends HeyApiClient {
2313
2333
  }
2314
2334
  });
2315
2335
  }
2316
- };
2317
- var Tarot = class extends HeyApiClient {
2318
2336
  /**
2319
- * List all 78 tarot cards
2320
- *
2321
- * Retrieve the complete Rider-Waite-Smith tarot deck of 78 cards: 22 Major Arcana (numbered 0-21, representing life lessons, spiritual themes, and karmic influences like The Fool, Death, The Tower) plus 56 Minor Arcana (4 suits × 14 cards each for daily situations and practical matters). Filter by arcana type (major for spiritual guidance, minor for everyday concerns), suit (cups for emotions and relationships, wands for creativity and passion, swords for intellect and conflict, pentacles for material wealth and finances), or card number (Ace=1 for new beginnings, 2-10 for progression, Page=11 for messages, Knight=12 for action, Queen=13 for mastery, King=14 for authority). Returns lightweight basic card data - use GET /cards/:id for full upright and reversed interpretations with keywords. Perfect for building tarot reference libraries, card databases, learning applications, or browsing the complete traditional deck used by professional tarot readers worldwide.
2322
- */
2323
- listCards(options) {
2324
- return (options?.client ?? this.client).get({
2325
- security: [{ name: "X-API-Key", type: "apiKey" }],
2326
- url: "/tarot/cards",
2327
- ...options
2328
- });
2329
- }
2330
- /**
2331
- * Get detailed tarot card information
2337
+ * Calculate Bridge Numbers - Harmonize different aspects of personality
2332
2338
  *
2333
- * Retrieve comprehensive details for a specific tarot card from the traditional Rider-Waite-Smith deck including complete upright meanings (card drawn normally) and reversed meanings (inverted/upside down interpretations for nuanced guidance). Each card provides keywords for quick reference, full interpretations (400+ words each for upright and reversed orientations), and guidance across life domains: love and relationships, career and professional growth, finances and material success, health and wellbeing, spirituality and personal development. Major Arcana cards (0-21) reveal deep spiritual lessons and life-changing themes. Minor Arcana cards (Ace through King in Cups, Wands, Swords, Pentacles) address practical daily situations and specific challenges. Use card ID in kebab-case format: Major Arcana like "fool", "magician", "death", "tower", or Minor Arcana like "ace-of-cups", "seven-of-wands", "queen-of-swords", "king-of-pentacles". Essential for detailed tarot study, reading interpretations, divination apps, fortune-telling platforms, spiritual guidance tools, and professional tarot learning applications.
2339
+ * Calculate three Bridge Numbers that reveal the adjustments needed to create harmony between different aspects of your numerology profile. Bridge Numbers are the absolute difference between pairs of core numbers: Life Path and Expression, Expression and Personality, Expression and Soul Urge. A Bridge of 0 means the two aspects are already aligned. Higher bridges (1 to 8) indicate greater tension and provide specific guidance on what changes to make. Bridge Numbers are essential for personal development, coaching applications, self-improvement platforms, and AI-powered personality analysis tools. Requires both a full birth name and birth date to calculate all four core numbers (Life Path, Expression, Soul Urge, Personality) internally before deriving the bridges.
2334
2340
  */
2335
- getCard(options) {
2336
- return (options.client ?? this.client).get({
2341
+ calculateBridgeNumbers(options) {
2342
+ return (options?.client ?? this.client).post({
2337
2343
  security: [{ name: "X-API-Key", type: "apiKey" }],
2338
- url: "/tarot/cards/{id}",
2339
- ...options
2344
+ url: "/numerology/bridge",
2345
+ ...options,
2346
+ headers: {
2347
+ "Content-Type": "application/json",
2348
+ ...options?.headers
2349
+ }
2340
2350
  });
2341
2351
  }
2342
2352
  /**
2343
- * Draw random tarot cards with reproducible results
2353
+ * Calculate Soul Urge number - Inner motivations and desires
2344
2354
  *
2345
- * Draw 1-78 tarot cards from the complete Rider-Waite-Smith deck with seeded reproducibility for consistent personalized readings. Provide an optional seed string (like "user123-2025-12-27" or "readingId") to ensure the same seed always returns identical cards in the exact same order - essential for daily tarot features, personalized user experiences, shareable readings, or reproducible testing. Omit seed for true random draws each time. Control card reversals (upright vs reversed/inverted orientations - reversed cards provide alternative meanings when drawn upside down) and duplicates (traditional deck draws each of 78 cards once, or oracle-style allows repeating same card). Each drawn card includes position number, reversal state (boolean), keywords for quick interpretation, full meaning text (400+ words), authentic Rider-Waite imagery, and card metadata. Perfect for custom spread builders, random card generators, automated tarot reading platforms, daily card features, meditation apps, journaling prompts, divination tools, and any application requiring reproducible or random tarot draws from the industry-standard 78-card deck (22 Major Arcana spiritual lessons + 56 Minor Arcana practical guidance across 4 suits).
2355
+ * Calculate your Soul Urge (Heart Desire) number from the vowels in your birth name using Pythagorean numerology. This number reveals your innermost desires, motivations, and what your soul truly wants to experience. It shows what drives you from within, your emotional needs, and what brings you fulfillment. Returns comprehensive interpretation including personality traits, emotional needs, relationship desires, and spiritual longings. Automatically detects Master Numbers (11, 22, 33). Perfect for self-discovery apps, emotional intelligence tools, relationship counseling platforms, and personal development services. Get detailed 300-500 word meanings for all numbers 1-9, 11, 22, and 33.
2346
2356
  */
2347
- drawCards(options) {
2348
- return (options.client ?? this.client).post({
2357
+ calculateSoulUrge(options) {
2358
+ return (options?.client ?? this.client).post({
2349
2359
  security: [{ name: "X-API-Key", type: "apiKey" }],
2350
- url: "/tarot/draw",
2360
+ url: "/numerology/soul-urge",
2351
2361
  ...options,
2352
2362
  headers: {
2353
2363
  "Content-Type": "application/json",
2354
- ...options.headers
2364
+ ...options?.headers
2355
2365
  }
2356
2366
  });
2357
2367
  }
2358
2368
  /**
2359
- * Get daily tarot card reading
2369
+ * Calculate Personality number - How others perceive you
2360
2370
  *
2361
- * Receive a single tarot card for daily guidance and reflection. This endpoint uses seeded randomness to ensure the same seed gets the same card on the same day - perfect for "Card of the Day" features. Provide a seed (userId, email hash, session token) for reproducible consistency, or omit for anonymous daily draws. Returns card with keywords, full meaning, and a daily message summary. Great for tarot apps, wellness platforms, morning ritual apps, and journaling tools.
2371
+ * Calculate your Personality number from the consonants in your birth name using Pythagorean numerology. This number reveals how others perceive you, your outer personality, and first impressions you make. It represents the mask you show the world and your social persona. Returns comprehensive interpretation including public image, social dynamics, professional presence, and relationship first impressions. Automatically detects Master Numbers (11, 22, 33). Perfect for personal branding apps, social skills training, professional development platforms, and communication coaching services. Get detailed 300-500 word meanings for all numbers 1-9, 11, 22, and 33.
2362
2372
  */
2363
- getDailyCard(options) {
2373
+ calculatePersonality(options) {
2364
2374
  return (options?.client ?? this.client).post({
2365
2375
  security: [{ name: "X-API-Key", type: "apiKey" }],
2366
- url: "/tarot/daily",
2376
+ url: "/numerology/personality",
2367
2377
  ...options,
2368
2378
  headers: {
2369
2379
  "Content-Type": "application/json",
@@ -2372,112 +2382,110 @@ var Tarot = class extends HeyApiClient {
2372
2382
  });
2373
2383
  }
2374
2384
  /**
2375
- * Get yes/no answer to your question
2385
+ * Calculate Birth Day number - Special talents from day of birth
2376
2386
  *
2377
- * Ask a specific question and receive a yes, no, or maybe answer based on a single tarot card draw. Upright cards indicate "Yes" with positive energy, reversed cards indicate "No" with caution, and certain inherently ambiguous cards (The Hanged Man, Wheel of Fortune, Temperance, Two of Swords, Four of Swords) return "Maybe" regardless of orientation since their energy signals pause, reflection, or shifting circumstances. Major Arcana cards give strong definitive answers, Minor Arcana cards give qualified nuanced answers. Returns the answer, strength level, drawn card details, and a contextual interpretation explaining why. Perfect for decision-making apps, quick guidance tools, fortune-telling chatbots, and interactive tarot experiences. Optionally provide a seed for reproducible answers.
2387
+ * Calculate your Birth Day number from the day you were born (1-31) using Pythagorean numerology. This number reveals special talents and abilities you possess from birth. It shows natural gifts that can help you achieve your life purpose. Returns comprehensive interpretation including innate talents, natural abilities, career advantages, and how to leverage your special gifts. Automatically detects Master Numbers (11, 22) and reduces double-digit days. Perfect for talent discovery apps, career counseling platforms, personal development services, and skill assessment tools. Get detailed 300-500 word meanings for all numbers 1-9, 11, and 22.
2378
2388
  */
2379
- castYesNo(options) {
2380
- return (options.client ?? this.client).post({
2389
+ calculateBirthDay(options) {
2390
+ return (options?.client ?? this.client).post({
2381
2391
  security: [{ name: "X-API-Key", type: "apiKey" }],
2382
- url: "/tarot/yes-no",
2392
+ url: "/numerology/birth-day",
2383
2393
  ...options,
2384
2394
  headers: {
2385
2395
  "Content-Type": "application/json",
2386
- ...options.headers
2396
+ ...options?.headers
2387
2397
  }
2388
2398
  });
2389
2399
  }
2390
2400
  /**
2391
- * Three-Card Spread: Past, Present, Future
2401
+ * Calculate Maturity number - Who you become in later life
2392
2402
  *
2393
- * Perform the classic three-card tarot spread revealing Past (what led to this situation), Present (current energy and circumstances), and Future (likely outcome if current path continues). The most popular beginner-friendly spread, perfect for quick insights, daily guidance, or exploring specific questions. Each position includes a drawn card with reversal state, keywords, full meaning, and position-specific interpretation. Returns a summary connecting all three cards. Ideal for tarot reading apps, decision-making tools, and personal growth platforms. Optionally provide a seed for reproducible readings.
2403
+ * Calculate your Maturity (Realization) number by adding Life Path and Expression numbers using Pythagorean numerology. This number reveals who you become in the second half of life, typically manifesting after age 35-40. It shows the ultimate goal of personal development and mature self-expression. Returns comprehensive interpretation including life transformation, mature personality, later-life purpose, and wisdom development. Automatically detects Master Numbers (11, 22, 33). Perfect for life coaching apps, midlife guidance platforms, personal development services, and aging wisdom tools. Get detailed 300-500 word meanings for all numbers 1-9, 11, 22, and 33.
2394
2404
  */
2395
- castThreeCard(options) {
2396
- return (options.client ?? this.client).post({
2405
+ calculateMaturity(options) {
2406
+ return (options?.client ?? this.client).post({
2397
2407
  security: [{ name: "X-API-Key", type: "apiKey" }],
2398
- url: "/tarot/spreads/three-card",
2408
+ url: "/numerology/maturity",
2399
2409
  ...options,
2400
2410
  headers: {
2401
2411
  "Content-Type": "application/json",
2402
- ...options.headers
2412
+ ...options?.headers
2403
2413
  }
2404
2414
  });
2405
2415
  }
2406
2416
  /**
2407
- * Celtic Cross Spread (10 cards)
2417
+ * Analyze Karmic Lessons - Life lessons from missing numbers
2408
2418
  *
2409
- * Perform the legendary Celtic Cross spread - the most comprehensive and detailed tarot reading available, used by professional tarot readers worldwide for over a century. This 10-card layout reveals the complete picture of any situation through distinct positions: Present Situation (what is happening now), Challenge (obstacles crossing your path), Distant Past (root causes), Recent Past (recent influences), Best Outcome (potential positive result), Near Future (what is approaching in weeks ahead), Your Approach (your attitude and self-perception), External Influences (environment and other people impact), Hopes and Fears (your desires and anxieties), and Final Outcome (where everything is headed). Perfect for life-changing decisions, complex relationship questions, career transitions, spiritual guidance, and deep self-discovery. Ideal for professional tarot apps, life coaching platforms, spiritual wellness websites, and divination tools requiring authoritative comprehensive readings. Each card position provides layered insight combining traditional tarot wisdom with modern psychological interpretation for actionable guidance.
2419
+ * Analyze your Karmic Lessons from your birth name using Pythagorean numerology. Karmic lessons are indicated by numbers missing from your name (numbers 1-9 that do not appear). These represent challenges you came to learn and skills you need to develop in this lifetime. Returns comprehensive analysis including missing numbers, specific lessons for each, challenges to overcome, and practical guidance for development. Perfect for spiritual growth apps, personal development platforms, life coaching services, and self-improvement tools. Get detailed lesson descriptions, development strategies, and practical exercises for each missing number.
2410
2420
  */
2411
- castCelticCross(options) {
2412
- return (options.client ?? this.client).post({
2421
+ analyzeKarmicLessons(options) {
2422
+ return (options?.client ?? this.client).post({
2413
2423
  security: [{ name: "X-API-Key", type: "apiKey" }],
2414
- url: "/tarot/spreads/celtic-cross",
2424
+ url: "/numerology/karmic-lessons",
2415
2425
  ...options,
2416
2426
  headers: {
2417
2427
  "Content-Type": "application/json",
2418
- ...options.headers
2428
+ ...options?.headers
2419
2429
  }
2420
2430
  });
2421
2431
  }
2422
2432
  /**
2423
- * Love Spread (5 cards)
2433
+ * Detect Karmic Debt numbers - Past life challenges (13, 14, 16, 19)
2424
2434
  *
2425
- * Perform a specialized 5-card relationship tarot spread analyzing romantic connections, emotional dynamics, and partnership potential. This love-focused reading examines five crucial relationship aspects: You (your current emotional state, needs, and what you bring to the relationship), Partner/Other (their emotional perspective, desires, and energy), Relationship Dynamic (the current energy and connection between you both), Challenge (obstacles needing attention, healing, or communication), and Outcome (where this romantic connection is naturally heading). Perfect for dating apps, relationship counseling platforms, matchmaking services, wellness apps, and romantic guidance tools. Provides deep insight into new relationships, existing partnerships, potential connections, breakup recovery, or self-love journeys. Ideal for understanding compatibility, resolving conflicts, strengthening bonds, or deciding whether to pursue or continue a relationship. Each position reveals emotional truths combining traditional tarot relationship wisdom with modern relationship psychology. Use for individual readings or couples readings to gain perspective on romantic situations from singleness to marriage.
2435
+ * Check for Karmic Debt numbers (13, 14, 16, 19) in Life Path, Expression, Soul Urge, or Personality calculations using Pythagorean numerology. Karmic debt indicates challenges carried from past lives that must be resolved in this lifetime. These numbers appear during reduction and represent specific lessons and tests. Returns comprehensive analysis including debt descriptions, challenges to overcome, and resolution guidance. Perfect for spiritual growth apps, karmic astrology platforms, past life exploration services, and personal transformation tools. Get detailed meanings for all four karmic debt numbers with practical resolution strategies.
2426
2436
  */
2427
- castLoveSpread(options) {
2428
- return (options.client ?? this.client).post({
2437
+ checkKarmicDebt(options) {
2438
+ return (options?.client ?? this.client).post({
2429
2439
  security: [{ name: "X-API-Key", type: "apiKey" }],
2430
- url: "/tarot/spreads/love",
2440
+ url: "/numerology/karmic-debt",
2431
2441
  ...options,
2432
2442
  headers: {
2433
2443
  "Content-Type": "application/json",
2434
- ...options.headers
2444
+ ...options?.headers
2435
2445
  }
2436
2446
  });
2437
2447
  }
2438
2448
  /**
2439
- * Career Spread (7 cards)
2449
+ * Calculate Personal Day - Daily personalized numerology forecast
2440
2450
  *
2441
- * Perform a comprehensive 7-card career tarot spread using SWOT analysis framework (Strengths, Weaknesses, Opportunities, Threats) for professional guidance, business decisions, and vocational clarity. This career-focused reading examines seven strategic business aspects: Current Situation (your present professional position and workplace energy), Strengths (your professional assets, talents, and competitive advantages), Weaknesses (areas needing development, skill gaps, or limiting beliefs), Opportunities (potential growth paths, new ventures, or doors opening), Threats (obstacles, competition, or external challenges), Advice (actionable guidance for navigating your career path), and Outcome (where your professional journey is heading if you follow the guidance). Perfect for career coaching platforms, professional development apps, business consulting tools, job search websites, entrepreneurship platforms, and executive coaching services. Use for career transitions, job offers evaluation, promotion decisions, starting a business, workplace conflicts, finding your calling, or strategic career planning. Combines traditional tarot wisdom with modern SWOT business analysis for practical professional insight. Ideal for employees, entrepreneurs, freelancers, career changers, and anyone seeking vocational direction.
2451
+ * Calculate your Personal Day number from birth month, day, and a target date. Personal Day is the most granular cycle in Pythagorean numerology, revealing the specific energy and theme for a single calendar day personalized to you. Unlike generic daily numbers, this is based on YOUR birth data combined with the calendar date. Returns the daily theme, actionable guidance, and parent month and year context. Perfect for daily push notifications, morning briefings, calendar widget integrations, daily content generation, and life coaching tools.
2442
2452
  */
2443
- castCareerSpread(options) {
2444
- return (options.client ?? this.client).post({
2453
+ calculatePersonalDay(options) {
2454
+ return (options?.client ?? this.client).post({
2445
2455
  security: [{ name: "X-API-Key", type: "apiKey" }],
2446
- url: "/tarot/spreads/career",
2456
+ url: "/numerology/personal-day",
2447
2457
  ...options,
2448
2458
  headers: {
2449
2459
  "Content-Type": "application/json",
2450
- ...options.headers
2460
+ ...options?.headers
2451
2461
  }
2452
2462
  });
2453
2463
  }
2454
2464
  /**
2455
- * Custom Spread Builder
2465
+ * Calculate Personal Month - Monthly numerology forecast
2456
2466
  *
2457
- * Build and perform your own custom tarot spread with personalized positions and interpretations (1-10 cards). This flexible endpoint lets you create unique spread layouts for any purpose - define your own position names, meanings, and card count to match your specific needs or therapeutic framework. Perfect for therapists using tarot in counseling, coaches creating signature spreads, app developers building custom reading features, spiritual practitioners with proprietary methods, or anyone wanting to design specialized layouts beyond traditional spreads. Create spreads for specific themes like chakra readings (7 cards), lunar phases (8 cards), elements (4 cards), goals setting (any count), shadow work, inner child healing, decision matrices, or creative problem-solving. Each position requires a name and interpretation - you define what each card position represents in your reading. The API draws the exact number of cards you specify and maps them to your custom positions. No pre-generated summary provided - you interpret the reading based on your framework. Ideal for innovative tarot apps, therapeutic tools, personal development platforms, spiritual coaching services, or experimental divination methods. Maximum 10 positions to maintain reading clarity and practical interpretation time.
2467
+ * Calculate your Personal Month number from birth month, day, and a target year and month. Personal Month reveals the specific theme and energy influencing each calendar month within your Personal Year cycle. Returns the monthly theme, practical focus guidance, and the parent Personal Year context. Perfect for monthly forecast features, push notification content, calendar integrations, editorial monthly columns, and life coaching tools.
2458
2468
  */
2459
- castCustomSpread(options) {
2460
- return (options.client ?? this.client).post({
2469
+ calculatePersonalMonth(options) {
2470
+ return (options?.client ?? this.client).post({
2461
2471
  security: [{ name: "X-API-Key", type: "apiKey" }],
2462
- url: "/tarot/spreads/custom",
2472
+ url: "/numerology/personal-month",
2463
2473
  ...options,
2464
2474
  headers: {
2465
2475
  "Content-Type": "application/json",
2466
- ...options.headers
2476
+ ...options?.headers
2467
2477
  }
2468
2478
  });
2469
2479
  }
2470
- };
2471
- var HumanDesign = class extends HeyApiClient {
2472
2480
  /**
2473
- * Generate full Human Design bodygraph - Type, authority, profile, centers, channels, gates
2481
+ * Calculate Personal Year - Annual cycle and forecast for current year
2474
2482
  *
2475
- * Generate a complete Human Design bodygraph from a birth date, time, and timezone. Returns the energy type, strategy, inner authority, signature, not-self theme, profile, definition, incarnation cross, all nine centers with defined state and active gates, the defined channels, and all 26 planetary activations across the Personality and Design sides. The single endpoint for a full chart in one call, built for Human Design apps, readings, and coaching tools.
2483
+ * Calculate your Personal Year number from your birth month, day, and current year using Pythagorean numerology. Personal Year runs in 9-year cycles (1-9) and reveals the theme, opportunities, and challenges for the current year. Each year has a specific energy and lessons. Returns comprehensive annual forecast including year theme, opportunities, challenges, and actionable advice. Perfect for yearly planning apps, life coaching platforms, astrology services, and personal development tools. Get detailed forecasts for all 9 Personal Year cycles with practical guidance.
2476
2484
  */
2477
- generateBodygraph(options) {
2485
+ calculatePersonalYear(options) {
2478
2486
  return (options?.client ?? this.client).post({
2479
2487
  security: [{ name: "X-API-Key", type: "apiKey" }],
2480
- url: "/human-design/bodygraph",
2488
+ url: "/numerology/personal-year",
2481
2489
  ...options,
2482
2490
  headers: {
2483
2491
  "Content-Type": "application/json",
@@ -2486,14 +2494,14 @@ var HumanDesign = class extends HeyApiClient {
2486
2494
  });
2487
2495
  }
2488
2496
  /**
2489
- * Calculate Human Design connection chart - Two-person composite bodygraph compatibility
2497
+ * Calculate Compatibility - Relationship dynamics between two people
2490
2498
  *
2491
- * Calculate a Human Design connection chart by overlaying two bodygraphs. For each of the 36 channels the dynamic between the two people is classified as electromagnetic, dominance, compromise, or companionship, the four mechanics of how two designs meet. Also returns the nine centers as defined or open in the combined bodygraph with which person defines each, the combined definition, and a count of each dynamic. Built for relationship, dating, and coaching tools.
2499
+ * Calculate numerology compatibility between two people using Pythagorean numerology. Accepts two input modes per person: pre-calculated Life Path, Expression, and Soul Urge numbers, or raw name and birthdate for automatic calculation. You can mix modes across persons (e.g. numbers for person1, raw inputs for person2). Provides comprehensive relationship analysis with overall compatibility score (0-100), individual aspect compatibility (Life Path 50% weight, Expression 30%, Soul Urge 20%), relationship strengths, challenges, and practical advice. Uses detailed compatibility matrix for all number combinations. Perfect for dating apps, relationship counseling platforms, matchmaking services, and compatibility tools. Get actionable insights for improving relationship dynamics.
2492
2500
  */
2493
- calculateConnection(options) {
2501
+ calculateNumCompatibility(options) {
2494
2502
  return (options?.client ?? this.client).post({
2495
2503
  security: [{ name: "X-API-Key", type: "apiKey" }],
2496
- url: "/human-design/connection",
2504
+ url: "/numerology/compatibility",
2497
2505
  ...options,
2498
2506
  headers: {
2499
2507
  "Content-Type": "application/json",
@@ -2502,14 +2510,14 @@ var HumanDesign = class extends HeyApiClient {
2502
2510
  });
2503
2511
  }
2504
2512
  /**
2505
- * Calculate Human Design Penta - Small-group BG5 operating system for three to five people
2513
+ * Generate Complete Numerology Chart - Full profile analysis
2506
2514
  *
2507
- * Calculate the Human Design Penta (BG5, Base Group 5) for a small group of three to five people. The Penta is a trans-auric form built from a fixed set of six channels running only between the Sacral, the G Center, and the Throat. It reports which of the twelve Penta gates are filled and by whom, which of the six channels are defined Strengths, the upper leadership channels versus the lower generative channels, the 2/14 material core, and the functional gaps where no member supplies a role. Built for team, family, and group analysis tools. Below three people no Penta forms and above five a second Penta emerges, so the group size must be three to five.
2515
+ * Generate a comprehensive numerology chart combining all major calculations: Life Path, Expression, Soul Urge, Personality, Birth Day, Maturity, Karmic Lessons, Karmic Debt, and Personal Year. This single endpoint provides everything needed for a full numerology reading. Returns detailed interpretations for all numbers, karmic analysis, yearly forecast, and holistic summary. Perfect for numerology apps, complete reading services, birth chart generators, and comprehensive analysis tools. Save multiple API calls by getting the full chart in one request. Ideal for generating PDF reports or detailed user profiles.
2508
2516
  */
2509
- calculatePenta(options) {
2517
+ generateNumerologyChart(options) {
2510
2518
  return (options?.client ?? this.client).post({
2511
2519
  security: [{ name: "X-API-Key", type: "apiKey" }],
2512
- url: "/human-design/penta",
2520
+ url: "/numerology/chart",
2513
2521
  ...options,
2514
2522
  headers: {
2515
2523
  "Content-Type": "application/json",
@@ -2518,30 +2526,26 @@ var HumanDesign = class extends HeyApiClient {
2518
2526
  });
2519
2527
  }
2520
2528
  /**
2521
- * Generate Human Design transit overlay - Current planetary activations on a natal bodygraph
2529
+ * Get Number Meaning - Interpretation for any number 1-9, 11, 22, 33
2522
2530
  *
2523
- * Overlay the current or any given planetary positions on a natal Human Design bodygraph to see which channels the transit temporarily completes. Returns the 13 transiting body activations with gate and line, the channels the transit completes beyond the natal definition split into personal channels where the transit supplies the partner gate of a natal gate and educational channels where the transit supplies both gates, the natally open centers those channels temporarily define, and a short factual summary. A transit is a single moment, so there is no Design side. When date and time are omitted the overlay is computed for now in UTC. Built for daily Human Design apps, transit widgets, and notification tools.
2531
+ * Get the complete meaning and interpretation for any numerology number (1-9, 11, 22, 33) using Pythagorean numerology. Returns comprehensive description including archetype title, keywords, personality traits, strengths, weaknesses, career guidance, relationship dynamics, and spiritual insights. Master numbers (11, 22, 33) include amplified meanings with their reduced base number. Perfect for numerology reference tools, educational apps, quick lookups, and building custom numerology calculators. Get detailed 300-500 word expert-written meanings for all 12 valid numerology numbers.
2524
2532
  */
2525
- generateTransit(options) {
2526
- return (options?.client ?? this.client).post({
2533
+ getNumberMeaning(options) {
2534
+ return (options.client ?? this.client).get({
2527
2535
  security: [{ name: "X-API-Key", type: "apiKey" }],
2528
- url: "/human-design/transit",
2529
- ...options,
2530
- headers: {
2531
- "Content-Type": "application/json",
2532
- ...options?.headers
2533
- }
2536
+ url: "/numerology/meanings/{number}",
2537
+ ...options
2534
2538
  });
2535
2539
  }
2536
2540
  /**
2537
- * Calculate Human Design type, authority and profile
2541
+ * Get daily numerology number - Number of the Day with interpretation
2538
2542
  *
2539
- * Calculate the core Human Design identity from a birth moment: the energy type, the aura strategy, the inner authority, the signature and not-self themes, and the profile. The fast lookup for type-and-authority features without the full bodygraph payload. Verified against NASA JPL Horizons positions.
2543
+ * Receive a daily numerology number (1-9, 11, 22, 33) for guidance and reflection. Uses seeded randomness so the same seed gets the same number on the same date, perfect for "Number of the Day" features in numerology apps, wellness platforms, and daily guidance tools. Returns the number with full interpretation including archetype, keywords, strengths, challenges, career, relationships, and spiritual insights. Ideal for daily push notifications, morning briefings, and personalized numerology experiences.
2540
2544
  */
2541
- calculateType(options) {
2545
+ getDailyNumber(options) {
2542
2546
  return (options?.client ?? this.client).post({
2543
2547
  security: [{ name: "X-API-Key", type: "apiKey" }],
2544
- url: "/human-design/type",
2548
+ url: "/numerology/daily",
2545
2549
  ...options,
2546
2550
  headers: {
2547
2551
  "Content-Type": "application/json",
@@ -2550,14 +2554,14 @@ var HumanDesign = class extends HeyApiClient {
2550
2554
  });
2551
2555
  }
2552
2556
  /**
2553
- * Calculate the 26 Human Design gate activations
2557
+ * Chaldean numerology name reading - Destiny, compound number, planetary ruler
2554
2558
  *
2555
- * Calculate the 26 gate activations for a birth moment, split into the 13 conscious Personality activations at birth and the 13 unconscious Design activations 88 degrees of solar arc earlier. Each activation reports the planet, gate, line, gate keynote, and the matching I-Ching hexagram. Built for activation columns and detailed chart views.
2559
+ * Calculate a complete Chaldean numerology reading for a name. The older Chaldean system maps letters to values 1 to 8 by vibration (the number 9 is sacred and never assigned to a letter) and reads the unreduced two-digit compound number (10 to 52, also called a fadic number, defined by Cheiro) in addition to the single-digit root. Returns the Destiny or name number from all letters, the Soul Urge from vowels, and the Personality from consonants, each with its compound number, root, and Cheiro compound interpretation, plus the planetary ruler of the Destiny root and a caution flag for the karmic numbers 4 and 8. Perfect for Chaldean numerology calculators, name analysis tools, and AI numerology assistants that need both the compound and root layers in one call.
2556
2560
  */
2557
- calculateGates(options) {
2561
+ calculateChaldean(options) {
2558
2562
  return (options?.client ?? this.client).post({
2559
2563
  security: [{ name: "X-API-Key", type: "apiKey" }],
2560
- url: "/human-design/gates",
2564
+ url: "/numerology/chaldean",
2561
2565
  ...options,
2562
2566
  headers: {
2563
2567
  "Content-Type": "application/json",
@@ -2566,26 +2570,26 @@ var HumanDesign = class extends HeyApiClient {
2566
2570
  });
2567
2571
  }
2568
2572
  /**
2569
- * Look up a Human Design gate by number
2573
+ * Compound number meaning - Cheiro Chaldean interpretation 10 to 52
2570
2574
  *
2571
- * Look up the static reference data for a Human Design gate by its number from 1 to 64: the gate keynote name, the center it sits in, the matching I-Ching hexagram, and the gates that form a channel with it. A pure reference endpoint with no birth data required.
2575
+ * Get the classical Chaldean interpretation of a compound number (also called a fadic number) from 10 to 52, as defined by Cheiro in the Book of Numbers. Compound numbers are the unreduced two-digit numbers that reveal the hidden influence behind a name or date, beyond the single-digit root. Each returns its symbolic title (such as The Wheel of Fortune for 10, The Star of the Magi for 17, or The Crown of the Magi for 21), its nature (fortunate, unfortunate, or mixed), and a full interpretation. Numbers 33 to 52 share the meaning of a lower number in their series, returned with a sameAs pointer. Perfect for Chaldean numerology references, compound number lookups, and AI numerology tools.
2572
2576
  */
2573
- getGate(options) {
2577
+ getCompoundNumber(options) {
2574
2578
  return (options.client ?? this.client).get({
2575
2579
  security: [{ name: "X-API-Key", type: "apiKey" }],
2576
- url: "/human-design/gates/{number}",
2580
+ url: "/numerology/compound-number/{number}",
2577
2581
  ...options
2578
2582
  });
2579
2583
  }
2580
2584
  /**
2581
- * Calculate the defined Human Design channels
2585
+ * Dual numerology - Pythagorean and Chaldean name numbers in one call
2582
2586
  *
2583
- * Calculate the defined channels for a birth moment. A channel is defined when both of its gates are activated, and it wires together the two centers it connects. Returns each defined channel with its gates, name, circuit family, and connected centers, plus the full set of centers those channels define. Built for bodygraph rendering and definition analysis.
2587
+ * Calculate a name number in both major numerology systems at once and compare them. The Pythagorean system maps letters 1 to 9 in alphabetical order and preserves master numbers (11, 22, 33), giving the Expression or Destiny number used in modern Western numerology. The Chaldean system maps letters 1 to 8 by vibration, reads the compound number (10 to 52), and reduces to a root 1 to 9. Returns both results with their interpretations, plus an agreement flag showing whether the two systems point to the same single-digit energy. The only numerology API that returns Pythagorean and Chaldean for a name in a single request, ideal for comparison tools and AI numerology assistants.
2584
2588
  */
2585
- calculateChannels(options) {
2589
+ calculateDual(options) {
2586
2590
  return (options?.client ?? this.client).post({
2587
2591
  security: [{ name: "X-API-Key", type: "apiKey" }],
2588
- url: "/human-design/channels",
2592
+ url: "/numerology/dual",
2589
2593
  ...options,
2590
2594
  headers: {
2591
2595
  "Content-Type": "application/json",
@@ -2594,14 +2598,14 @@ var HumanDesign = class extends HeyApiClient {
2594
2598
  });
2595
2599
  }
2596
2600
  /**
2597
- * Calculate the nine Human Design centers
2601
+ * Business name numerology - Chaldean brand name analysis and lucky numbers
2598
2602
  *
2599
- * Calculate the state of all nine Human Design centers for a birth moment: whether each is defined or open, whether it is a motor or an awareness center, its theme, and the active gates it holds. The data layer behind a rendered bodygraph where defined centers are colored and open centers are white.
2603
+ * Analyze a business or brand name with Chaldean numerology, the system practitioners use for trade names. Returns the name number (compound and root), its planetary ruler, an overall business rating, the industries the number favors, and whether the compound is one of Cheiro fortunate compounds. The most favorable business roots are 1 (leadership), 3 (expansion), 5 (commerce) and 6 (beauty and hospitality); the numbers 4 and 8 carry caution as the karmic numbers of instability and heavy demand. Use it to vet a company name, compare brand options, or guide a naming decision. This is positioning guidance layered over the fundamentals of a memorable, available name, not a guarantee.
2600
2604
  */
2601
- calculateCenters(options) {
2605
+ calculateBusinessName(options) {
2602
2606
  return (options?.client ?? this.client).post({
2603
2607
  security: [{ name: "X-API-Key", type: "apiKey" }],
2604
- url: "/human-design/centers",
2608
+ url: "/numerology/business-name",
2605
2609
  ...options,
2606
2610
  headers: {
2607
2611
  "Content-Type": "application/json",
@@ -2609,43 +2613,57 @@ var HumanDesign = class extends HeyApiClient {
2609
2613
  }
2610
2614
  });
2611
2615
  }
2616
+ };
2617
+ var Tarot = class extends HeyApiClient {
2612
2618
  /**
2613
- * Look up a Human Design center by id
2619
+ * List all 78 tarot cards
2614
2620
  *
2615
- * Look up the static reference data for one of the nine Human Design centers by its id: the display name, whether it is a motor or awareness center, and what it means both defined and undefined. A pure reference endpoint with no birth data required.
2621
+ * Retrieve the complete Rider-Waite-Smith tarot deck of 78 cards: 22 Major Arcana (numbered 0-21, representing life lessons, spiritual themes, and karmic influences like The Fool, Death, The Tower) plus 56 Minor Arcana (4 suits × 14 cards each for daily situations and practical matters). Filter by arcana type (major for spiritual guidance, minor for everyday concerns), suit (cups for emotions and relationships, wands for creativity and passion, swords for intellect and conflict, pentacles for material wealth and finances), or card number (Ace=1 for new beginnings, 2-10 for progression, Page=11 for messages, Knight=12 for action, Queen=13 for mastery, King=14 for authority). Returns lightweight basic card data - use GET /cards/:id for full upright and reversed interpretations with keywords. Perfect for building tarot reference libraries, card databases, learning applications, or browsing the complete traditional deck used by professional tarot readers worldwide.
2616
2622
  */
2617
- getCenter(options) {
2623
+ listCards(options) {
2624
+ return (options?.client ?? this.client).get({
2625
+ security: [{ name: "X-API-Key", type: "apiKey" }],
2626
+ url: "/tarot/cards",
2627
+ ...options
2628
+ });
2629
+ }
2630
+ /**
2631
+ * Get detailed tarot card information
2632
+ *
2633
+ * Retrieve comprehensive details for a specific tarot card from the traditional Rider-Waite-Smith deck including complete upright meanings (card drawn normally) and reversed meanings (inverted/upside down interpretations for nuanced guidance). Each card provides keywords for quick reference, full interpretations (400+ words each for upright and reversed orientations), and guidance across life domains: love and relationships, career and professional growth, finances and material success, health and wellbeing, spirituality and personal development. Major Arcana cards (0-21) reveal deep spiritual lessons and life-changing themes. Minor Arcana cards (Ace through King in Cups, Wands, Swords, Pentacles) address practical daily situations and specific challenges. Use card ID in kebab-case format: Major Arcana like "fool", "magician", "death", "tower", or Minor Arcana like "ace-of-cups", "seven-of-wands", "queen-of-swords", "king-of-pentacles". Essential for detailed tarot study, reading interpretations, divination apps, fortune-telling platforms, spiritual guidance tools, and professional tarot learning applications.
2634
+ */
2635
+ getCard(options) {
2618
2636
  return (options.client ?? this.client).get({
2619
2637
  security: [{ name: "X-API-Key", type: "apiKey" }],
2620
- url: "/human-design/centers/{id}",
2638
+ url: "/tarot/cards/{id}",
2621
2639
  ...options
2622
2640
  });
2623
2641
  }
2624
2642
  /**
2625
- * Calculate the Human Design profile and line keynotes
2643
+ * Draw random tarot cards with reproducible results
2626
2644
  *
2627
- * Calculate the Human Design profile for a birth moment: the conscious Personality Sun line over the unconscious Design Sun line, with the keynote for each. The profile is the geometry of the life role, for example 5/1 the Heretic Investigator. Verified against NASA JPL Horizons positions.
2645
+ * Draw 1-78 tarot cards from the complete Rider-Waite-Smith deck with seeded reproducibility for consistent personalized readings. Provide an optional seed string (like "user123-2025-12-27" or "readingId") to ensure the same seed always returns identical cards in the exact same order - essential for daily tarot features, personalized user experiences, shareable readings, or reproducible testing. Omit seed for true random draws each time. Control card reversals (upright vs reversed/inverted orientations - reversed cards provide alternative meanings when drawn upside down) and duplicates (traditional deck draws each of 78 cards once, or oracle-style allows repeating same card). Each drawn card includes position number, reversal state (boolean), keywords for quick interpretation, full meaning text (400+ words), authentic Rider-Waite imagery, and card metadata. Perfect for custom spread builders, random card generators, automated tarot reading platforms, daily card features, meditation apps, journaling prompts, divination tools, and any application requiring reproducible or random tarot draws from the industry-standard 78-card deck (22 Major Arcana spiritual lessons + 56 Minor Arcana practical guidance across 4 suits).
2628
2646
  */
2629
- calculateProfile(options) {
2630
- return (options?.client ?? this.client).post({
2647
+ drawCards(options) {
2648
+ return (options.client ?? this.client).post({
2631
2649
  security: [{ name: "X-API-Key", type: "apiKey" }],
2632
- url: "/human-design/profile",
2650
+ url: "/tarot/draw",
2633
2651
  ...options,
2634
2652
  headers: {
2635
2653
  "Content-Type": "application/json",
2636
- ...options?.headers
2654
+ ...options.headers
2637
2655
  }
2638
2656
  });
2639
2657
  }
2640
2658
  /**
2641
- * Calculate Human Design Variables - The four arrows and Color, Tone, Base substructure
2659
+ * Get daily tarot card reading
2642
2660
  *
2643
- * Calculate the four Human Design Variable arrows for a birth moment: Determination and Environment on the design side, Perspective and Motivation on the personality side. Each arrow returns its Color, Tone, and Base numbers from the hexagram-line substructure, the left or right direction set by the Tone, and the sourced Color and direction labels. This is the advanced Rave Variables and Primary Health System layer beneath Type, Strategy, Authority, and Profile. Color, Tone, and Base shift with tiny differences in birth time, so each arrow carries a confidence flag that turns false near a Color or Tone boundary, and a precise birth time is essential. Built for Human Design apps offering PHS, diet, environment, and Rave Psychology readings.
2661
+ * Receive a single tarot card for daily guidance and reflection. This endpoint uses seeded randomness to ensure the same seed gets the same card on the same day - perfect for "Card of the Day" features. Provide a seed (userId, email hash, session token) for reproducible consistency, or omit for anonymous daily draws. Returns card with keywords, full meaning, and a daily message summary. Great for tarot apps, wellness platforms, morning ritual apps, and journaling tools.
2644
2662
  */
2645
- calculateVariables(options) {
2663
+ getDailyCard(options) {
2646
2664
  return (options?.client ?? this.client).post({
2647
2665
  security: [{ name: "X-API-Key", type: "apiKey" }],
2648
- url: "/human-design/variables",
2666
+ url: "/tarot/daily",
2649
2667
  ...options,
2650
2668
  headers: {
2651
2669
  "Content-Type": "application/json",
@@ -2653,85 +2671,99 @@ var HumanDesign = class extends HeyApiClient {
2653
2671
  }
2654
2672
  });
2655
2673
  }
2656
- };
2657
- var Forecast = class extends HeyApiClient {
2658
2674
  /**
2659
- * Cross-domain forecast timeline - Transits, ingresses, stations, dasha changes, critical days
2675
+ * Get yes/no answer to your question
2660
2676
  *
2661
- * Build one time-ordered forecast for a single birth subject by merging upcoming events across three domains: western transit-to-natal aspects, sign ingresses, retrograde stations, eclipses, and new and full moons; biorhythm critical days; and vedic Vimshottari mahadasha, antardasha, and pratyantardasha boundaries. The window is clamped to 90 days and events are capped and scored by significance. Built for what-is-coming dashboards, daily and weekly forecast feeds, and timing tools.
2677
+ * Ask a specific question and receive a yes, no, or maybe answer based on a single tarot card draw. Upright cards indicate "Yes" with positive energy, reversed cards indicate "No" with caution, and certain inherently ambiguous cards (The Hanged Man, Wheel of Fortune, Temperance, Two of Swords, Four of Swords) return "Maybe" regardless of orientation since their energy signals pause, reflection, or shifting circumstances. Major Arcana cards give strong definitive answers, Minor Arcana cards give qualified nuanced answers. Returns the answer, strength level, drawn card details, and a contextual interpretation explaining why. Perfect for decision-making apps, quick guidance tools, fortune-telling chatbots, and interactive tarot experiences. Optionally provide a seed for reproducible answers.
2662
2678
  */
2663
- generateTimeline(options) {
2664
- return (options?.client ?? this.client).post({
2679
+ castYesNo(options) {
2680
+ return (options.client ?? this.client).post({
2665
2681
  security: [{ name: "X-API-Key", type: "apiKey" }],
2666
- url: "/forecast/timeline",
2682
+ url: "/tarot/yes-no",
2667
2683
  ...options,
2668
2684
  headers: {
2669
2685
  "Content-Type": "application/json",
2670
- ...options?.headers
2686
+ ...options.headers
2671
2687
  }
2672
2688
  });
2673
2689
  }
2674
2690
  /**
2675
- * Western astrology forecast - aspects, ingresses, stations, eclipses, moon phases
2691
+ * Three-Card Spread: Past, Present, Future
2676
2692
  *
2677
- * Forecast the western astrology events for a single birth chart over a window up to 90 days: every transit-to-natal major aspect refined to its exact instant, every transiting planet sign ingress, every retrograde or direct station, every solar and lunar eclipse, and every New and Full Moon. Returns a time-ordered, significance-scored timeline. Built for astrology forecast feeds, transit alerts, and timing tools.
2693
+ * Perform the classic three-card tarot spread revealing Past (what led to this situation), Present (current energy and circumstances), and Future (likely outcome if current path continues). The most popular beginner-friendly spread, perfect for quick insights, daily guidance, or exploring specific questions. Each position includes a drawn card with reversal state, keywords, full meaning, and position-specific interpretation. Returns a summary connecting all three cards. Ideal for tarot reading apps, decision-making tools, and personal growth platforms. Optionally provide a seed for reproducible readings.
2678
2694
  */
2679
- forecastTransits(options) {
2680
- return (options?.client ?? this.client).post({
2695
+ castThreeCard(options) {
2696
+ return (options.client ?? this.client).post({
2681
2697
  security: [{ name: "X-API-Key", type: "apiKey" }],
2682
- url: "/forecast/transits",
2698
+ url: "/tarot/spreads/three-card",
2683
2699
  ...options,
2684
2700
  headers: {
2685
2701
  "Content-Type": "application/json",
2686
- ...options?.headers
2702
+ ...options.headers
2687
2703
  }
2688
2704
  });
2689
2705
  }
2690
2706
  /**
2691
- * Significant dates - High-significance cross-domain forecast highlights
2707
+ * Celtic Cross Spread (10 cards)
2692
2708
  *
2693
- * Return only the high-significance dates from the merged cross-domain forecast for a single birth subject: the rare outer-planet exact transit aspects, slow-planet sign ingresses, retrograde stations, and Vimshottari mahadasha and antardasha changes that mark genuine turning points. Defaults to a significance floor of 70 so the response is a short list of the most meaningful upcoming dates. Built for what-is-coming highlights, timing alerts, and at-a-glance forecast strips.
2709
+ * Perform the legendary Celtic Cross spread - the most comprehensive and detailed tarot reading available, used by professional tarot readers worldwide for over a century. This 10-card layout reveals the complete picture of any situation through distinct positions: Present Situation (what is happening now), Challenge (obstacles crossing your path), Distant Past (root causes), Recent Past (recent influences), Best Outcome (potential positive result), Near Future (what is approaching in weeks ahead), Your Approach (your attitude and self-perception), External Influences (environment and other people impact), Hopes and Fears (your desires and anxieties), and Final Outcome (where everything is headed). Perfect for life-changing decisions, complex relationship questions, career transitions, spiritual guidance, and deep self-discovery. Ideal for professional tarot apps, life coaching platforms, spiritual wellness websites, and divination tools requiring authoritative comprehensive readings. Each card position provides layered insight combining traditional tarot wisdom with modern psychological interpretation for actionable guidance.
2694
2710
  */
2695
- findSignificantDates(options) {
2696
- return (options?.client ?? this.client).post({
2711
+ castCelticCross(options) {
2712
+ return (options.client ?? this.client).post({
2697
2713
  security: [{ name: "X-API-Key", type: "apiKey" }],
2698
- url: "/forecast/significant-dates",
2714
+ url: "/tarot/spreads/celtic-cross",
2699
2715
  ...options,
2700
2716
  headers: {
2701
2717
  "Content-Type": "application/json",
2702
- ...options?.headers
2718
+ ...options.headers
2703
2719
  }
2704
2720
  });
2705
2721
  }
2706
2722
  /**
2707
- * Forecast digest - Pre-summarized next 24h, 7d, 30d, and 90d rollups
2723
+ * Love Spread (5 cards)
2708
2724
  *
2709
- * Roll the cross-domain forecast for a single birth subject into four pre-summarized windows: the next 24 hours, 7 days, 30 days, and 90 days from the start date. Each window returns its event count, a per-domain count breakdown, a per-type count breakdown, and the top highest-significance events. Built for a glanceable what-is-coming strip so a caller can render the upcoming highlights without scanning the full event list.
2725
+ * Perform a specialized 5-card relationship tarot spread analyzing romantic connections, emotional dynamics, and partnership potential. This love-focused reading examines five crucial relationship aspects: You (your current emotional state, needs, and what you bring to the relationship), Partner/Other (their emotional perspective, desires, and energy), Relationship Dynamic (the current energy and connection between you both), Challenge (obstacles needing attention, healing, or communication), and Outcome (where this romantic connection is naturally heading). Perfect for dating apps, relationship counseling platforms, matchmaking services, wellness apps, and romantic guidance tools. Provides deep insight into new relationships, existing partnerships, potential connections, breakup recovery, or self-love journeys. Ideal for understanding compatibility, resolving conflicts, strengthening bonds, or deciding whether to pursue or continue a relationship. Each position reveals emotional truths combining traditional tarot relationship wisdom with modern relationship psychology. Use for individual readings or couples readings to gain perspective on romantic situations from singleness to marriage.
2710
2726
  */
2711
- generateDigest(options) {
2712
- return (options?.client ?? this.client).post({
2727
+ castLoveSpread(options) {
2728
+ return (options.client ?? this.client).post({
2713
2729
  security: [{ name: "X-API-Key", type: "apiKey" }],
2714
- url: "/forecast/digest",
2730
+ url: "/tarot/spreads/love",
2715
2731
  ...options,
2716
2732
  headers: {
2717
2733
  "Content-Type": "application/json",
2718
- ...options?.headers
2734
+ ...options.headers
2719
2735
  }
2720
2736
  });
2721
2737
  }
2722
2738
  /**
2723
- * Solar return chart - Annual birthday forecast chart for a single subject
2739
+ * Career Spread (7 cards)
2724
2740
  *
2725
- * Cast the solar return chart for one subject and year: the chart erected for the exact moment the transiting Sun returns to its natal ecliptic longitude, the foundational technique for annual astrological forecasting. Returns the full tropical chart with planetary positions, house cusps, aspects, Ascendant, and Midheaven. Location-sensitive: pass the birthplace to anchor the chart to natal geography, or the current city for a relocated solar return where the houses and Ascendant shift to where you are on your birthday. Built for year-ahead forecast tools, birthday charts, and annual horoscope features.
2741
+ * Perform a comprehensive 7-card career tarot spread using SWOT analysis framework (Strengths, Weaknesses, Opportunities, Threats) for professional guidance, business decisions, and vocational clarity. This career-focused reading examines seven strategic business aspects: Current Situation (your present professional position and workplace energy), Strengths (your professional assets, talents, and competitive advantages), Weaknesses (areas needing development, skill gaps, or limiting beliefs), Opportunities (potential growth paths, new ventures, or doors opening), Threats (obstacles, competition, or external challenges), Advice (actionable guidance for navigating your career path), and Outcome (where your professional journey is heading if you follow the guidance). Perfect for career coaching platforms, professional development apps, business consulting tools, job search websites, entrepreneurship platforms, and executive coaching services. Use for career transitions, job offers evaluation, promotion decisions, starting a business, workplace conflicts, finding your calling, or strategic career planning. Combines traditional tarot wisdom with modern SWOT business analysis for practical professional insight. Ideal for employees, entrepreneurs, freelancers, career changers, and anyone seeking vocational direction.
2726
2742
  */
2727
- forecastSolarReturn(options) {
2728
- return (options?.client ?? this.client).post({
2743
+ castCareerSpread(options) {
2744
+ return (options.client ?? this.client).post({
2729
2745
  security: [{ name: "X-API-Key", type: "apiKey" }],
2730
- url: "/forecast/solar-return",
2746
+ url: "/tarot/spreads/career",
2731
2747
  ...options,
2732
2748
  headers: {
2733
2749
  "Content-Type": "application/json",
2734
- ...options?.headers
2750
+ ...options.headers
2751
+ }
2752
+ });
2753
+ }
2754
+ /**
2755
+ * Custom Spread Builder
2756
+ *
2757
+ * Build and perform your own custom tarot spread with personalized positions and interpretations (1-10 cards). This flexible endpoint lets you create unique spread layouts for any purpose - define your own position names, meanings, and card count to match your specific needs or therapeutic framework. Perfect for therapists using tarot in counseling, coaches creating signature spreads, app developers building custom reading features, spiritual practitioners with proprietary methods, or anyone wanting to design specialized layouts beyond traditional spreads. Create spreads for specific themes like chakra readings (7 cards), lunar phases (8 cards), elements (4 cards), goals setting (any count), shadow work, inner child healing, decision matrices, or creative problem-solving. Each position requires a name and interpretation - you define what each card position represents in your reading. The API draws the exact number of cards you specify and maps them to your custom positions. No pre-generated summary provided - you interpret the reading based on your framework. Ideal for innovative tarot apps, therapeutic tools, personal development platforms, spiritual coaching services, or experimental divination methods. Maximum 10 positions to maintain reading clarity and practical interpretation time.
2758
+ */
2759
+ castCustomSpread(options) {
2760
+ return (options.client ?? this.client).post({
2761
+ security: [{ name: "X-API-Key", type: "apiKey" }],
2762
+ url: "/tarot/spreads/custom",
2763
+ ...options,
2764
+ headers: {
2765
+ "Content-Type": "application/json",
2766
+ ...options.headers
2735
2767
  }
2736
2768
  });
2737
2769
  }
@@ -3302,6 +3334,14 @@ var Roxy = class _Roxy extends HeyApiClient {
3302
3334
  get vedicAstrology() {
3303
3335
  return this._vedicAstrology ??= new VedicAstrology({ client: this.client });
3304
3336
  }
3337
+ _forecast;
3338
+ get forecast() {
3339
+ return this._forecast ??= new Forecast({ client: this.client });
3340
+ }
3341
+ _humanDesign;
3342
+ get humanDesign() {
3343
+ return this._humanDesign ??= new HumanDesign({ client: this.client });
3344
+ }
3305
3345
  _numerology;
3306
3346
  get numerology() {
3307
3347
  return this._numerology ??= new Numerology({ client: this.client });
@@ -3310,14 +3350,6 @@ var Roxy = class _Roxy extends HeyApiClient {
3310
3350
  get tarot() {
3311
3351
  return this._tarot ??= new Tarot({ client: this.client });
3312
3352
  }
3313
- _humanDesign;
3314
- get humanDesign() {
3315
- return this._humanDesign ??= new HumanDesign({ client: this.client });
3316
- }
3317
- _forecast;
3318
- get forecast() {
3319
- return this._forecast ??= new Forecast({ client: this.client });
3320
- }
3321
3353
  _biorhythm;
3322
3354
  get biorhythm() {
3323
3355
  return this._biorhythm ??= new Biorhythm({ client: this.client });
@@ -3353,7 +3385,7 @@ var Roxy = class _Roxy extends HeyApiClient {
3353
3385
  };
3354
3386
 
3355
3387
  // src/version.ts
3356
- var VERSION = "1.2.48";
3388
+ var VERSION = "1.2.50";
3357
3389
 
3358
3390
  // src/factory.ts
3359
3391
  function createRoxy(auth) {