@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.js CHANGED
@@ -615,9 +615,9 @@ var VedicAstrology = class extends HeyApiClient {
615
615
  });
616
616
  }
617
617
  /**
618
- * Get current Mahadasha, Antardasha, Pratyantardasha - Dasha Calculator API
618
+ * Get current Mahadasha, Antardasha, Pratyantardasha, Sookshma - Dasha Calculator API
619
619
  *
620
- * 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.
620
+ * 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.
621
621
  */
622
622
  getCurrentDasha(options) {
623
623
  return (options?.client ?? this.client).post({
@@ -662,6 +662,38 @@ var VedicAstrology = class extends HeyApiClient {
662
662
  }
663
663
  });
664
664
  }
665
+ /**
666
+ * Get all Pratyantardashas (antara periods) for a Mahadasha and Antardasha
667
+ *
668
+ * 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.
669
+ */
670
+ getPratyantardashas(options) {
671
+ return (options.client ?? this.client).post({
672
+ security: [{ name: "X-API-Key", type: "apiKey" }],
673
+ url: "/vedic-astrology/dasha/sub/{mahadasha}/{antardasha}",
674
+ ...options,
675
+ headers: {
676
+ "Content-Type": "application/json",
677
+ ...options.headers
678
+ }
679
+ });
680
+ }
681
+ /**
682
+ * Get all Sookshma dashas for a Mahadasha, Antardasha and Pratyantardasha
683
+ *
684
+ * 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.
685
+ */
686
+ getSookshmaDashas(options) {
687
+ return (options.client ?? this.client).post({
688
+ security: [{ name: "X-API-Key", type: "apiKey" }],
689
+ url: "/vedic-astrology/dasha/sub/{mahadasha}/{antardasha}/{pratyantardasha}",
690
+ ...options,
691
+ headers: {
692
+ "Content-Type": "application/json",
693
+ ...options.headers
694
+ }
695
+ });
696
+ }
665
697
  /**
666
698
  * Get basic Panchang - Tithi Nakshatra Yoga Karana Calculator
667
699
  *
@@ -1179,16 +1211,16 @@ var VedicAstrology = class extends HeyApiClient {
1179
1211
  });
1180
1212
  }
1181
1213
  };
1182
- var Numerology = class extends HeyApiClient {
1214
+ var Forecast = class extends HeyApiClient {
1183
1215
  /**
1184
- * Calculate Life Path number - Most important numerology calculation
1216
+ * Cross-domain forecast timeline - Transits, ingresses, stations, dasha changes, critical days
1185
1217
  *
1186
- * 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.
1218
+ * 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.
1187
1219
  */
1188
- calculateLifePath(options) {
1220
+ generateTimeline(options) {
1189
1221
  return (options?.client ?? this.client).post({
1190
1222
  security: [{ name: "X-API-Key", type: "apiKey" }],
1191
- url: "/numerology/life-path",
1223
+ url: "/forecast/timeline",
1192
1224
  ...options,
1193
1225
  headers: {
1194
1226
  "Content-Type": "application/json",
@@ -1197,14 +1229,14 @@ var Numerology = class extends HeyApiClient {
1197
1229
  });
1198
1230
  }
1199
1231
  /**
1200
- * Calculate Expression number - Natural talents and life goals
1232
+ * Western astrology forecast - aspects, ingresses, stations, eclipses, moon phases
1201
1233
  *
1202
- * 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.
1234
+ * 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.
1203
1235
  */
1204
- calculateExpression(options) {
1236
+ forecastTransits(options) {
1205
1237
  return (options?.client ?? this.client).post({
1206
1238
  security: [{ name: "X-API-Key", type: "apiKey" }],
1207
- url: "/numerology/expression",
1239
+ url: "/forecast/transits",
1208
1240
  ...options,
1209
1241
  headers: {
1210
1242
  "Content-Type": "application/json",
@@ -1213,14 +1245,14 @@ var Numerology = class extends HeyApiClient {
1213
1245
  });
1214
1246
  }
1215
1247
  /**
1216
- * Calculate Bridge Numbers - Harmonize different aspects of personality
1248
+ * Significant dates - High-significance cross-domain forecast highlights
1217
1249
  *
1218
- * 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.
1250
+ * 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.
1219
1251
  */
1220
- calculateBridgeNumbers(options) {
1252
+ findSignificantDates(options) {
1221
1253
  return (options?.client ?? this.client).post({
1222
1254
  security: [{ name: "X-API-Key", type: "apiKey" }],
1223
- url: "/numerology/bridge",
1255
+ url: "/forecast/significant-dates",
1224
1256
  ...options,
1225
1257
  headers: {
1226
1258
  "Content-Type": "application/json",
@@ -1229,14 +1261,14 @@ var Numerology = class extends HeyApiClient {
1229
1261
  });
1230
1262
  }
1231
1263
  /**
1232
- * Calculate Soul Urge number - Inner motivations and desires
1264
+ * Forecast digest - Pre-summarized next 24h, 7d, 30d, and 90d rollups
1233
1265
  *
1234
- * 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.
1266
+ * 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.
1235
1267
  */
1236
- calculateSoulUrge(options) {
1268
+ generateDigest(options) {
1237
1269
  return (options?.client ?? this.client).post({
1238
1270
  security: [{ name: "X-API-Key", type: "apiKey" }],
1239
- url: "/numerology/soul-urge",
1271
+ url: "/forecast/digest",
1240
1272
  ...options,
1241
1273
  headers: {
1242
1274
  "Content-Type": "application/json",
@@ -1245,14 +1277,14 @@ var Numerology = class extends HeyApiClient {
1245
1277
  });
1246
1278
  }
1247
1279
  /**
1248
- * Calculate Personality number - How others perceive you
1280
+ * Solar return chart - Annual birthday forecast chart for a single subject
1249
1281
  *
1250
- * 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.
1282
+ * 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.
1251
1283
  */
1252
- calculatePersonality(options) {
1284
+ forecastSolarReturn(options) {
1253
1285
  return (options?.client ?? this.client).post({
1254
1286
  security: [{ name: "X-API-Key", type: "apiKey" }],
1255
- url: "/numerology/personality",
1287
+ url: "/forecast/solar-return",
1256
1288
  ...options,
1257
1289
  headers: {
1258
1290
  "Content-Type": "application/json",
@@ -1260,15 +1292,17 @@ var Numerology = class extends HeyApiClient {
1260
1292
  }
1261
1293
  });
1262
1294
  }
1295
+ };
1296
+ var HumanDesign = class extends HeyApiClient {
1263
1297
  /**
1264
- * Calculate Birth Day number - Special talents from day of birth
1298
+ * Generate full Human Design bodygraph - Type, authority, profile, centers, channels, gates
1265
1299
  *
1266
- * 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.
1300
+ * 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.
1267
1301
  */
1268
- calculateBirthDay(options) {
1302
+ generateBodygraph(options) {
1269
1303
  return (options?.client ?? this.client).post({
1270
1304
  security: [{ name: "X-API-Key", type: "apiKey" }],
1271
- url: "/numerology/birth-day",
1305
+ url: "/human-design/bodygraph",
1272
1306
  ...options,
1273
1307
  headers: {
1274
1308
  "Content-Type": "application/json",
@@ -1277,14 +1311,14 @@ var Numerology = class extends HeyApiClient {
1277
1311
  });
1278
1312
  }
1279
1313
  /**
1280
- * Calculate Maturity number - Who you become in later life
1314
+ * Calculate Human Design connection chart - Two-person composite bodygraph compatibility
1281
1315
  *
1282
- * 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.
1316
+ * 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.
1283
1317
  */
1284
- calculateMaturity(options) {
1318
+ calculateConnection(options) {
1285
1319
  return (options?.client ?? this.client).post({
1286
1320
  security: [{ name: "X-API-Key", type: "apiKey" }],
1287
- url: "/numerology/maturity",
1321
+ url: "/human-design/connection",
1288
1322
  ...options,
1289
1323
  headers: {
1290
1324
  "Content-Type": "application/json",
@@ -1293,14 +1327,14 @@ var Numerology = class extends HeyApiClient {
1293
1327
  });
1294
1328
  }
1295
1329
  /**
1296
- * Analyze Karmic Lessons - Life lessons from missing numbers
1330
+ * Calculate Human Design Penta - Small-group BG5 operating system for three to five people
1297
1331
  *
1298
- * 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.
1332
+ * 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.
1299
1333
  */
1300
- analyzeKarmicLessons(options) {
1334
+ calculatePenta(options) {
1301
1335
  return (options?.client ?? this.client).post({
1302
1336
  security: [{ name: "X-API-Key", type: "apiKey" }],
1303
- url: "/numerology/karmic-lessons",
1337
+ url: "/human-design/penta",
1304
1338
  ...options,
1305
1339
  headers: {
1306
1340
  "Content-Type": "application/json",
@@ -1309,14 +1343,14 @@ var Numerology = class extends HeyApiClient {
1309
1343
  });
1310
1344
  }
1311
1345
  /**
1312
- * Detect Karmic Debt numbers - Past life challenges (13, 14, 16, 19)
1346
+ * Generate Human Design transit overlay - Current planetary activations on a natal bodygraph
1313
1347
  *
1314
- * 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.
1348
+ * 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.
1315
1349
  */
1316
- checkKarmicDebt(options) {
1350
+ generateTransit(options) {
1317
1351
  return (options?.client ?? this.client).post({
1318
1352
  security: [{ name: "X-API-Key", type: "apiKey" }],
1319
- url: "/numerology/karmic-debt",
1353
+ url: "/human-design/transit",
1320
1354
  ...options,
1321
1355
  headers: {
1322
1356
  "Content-Type": "application/json",
@@ -1325,14 +1359,14 @@ var Numerology = class extends HeyApiClient {
1325
1359
  });
1326
1360
  }
1327
1361
  /**
1328
- * Calculate Personal Day - Daily personalized numerology forecast
1362
+ * Calculate Human Design type, authority and profile
1329
1363
  *
1330
- * 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.
1364
+ * 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.
1331
1365
  */
1332
- calculatePersonalDay(options) {
1366
+ calculateType(options) {
1333
1367
  return (options?.client ?? this.client).post({
1334
1368
  security: [{ name: "X-API-Key", type: "apiKey" }],
1335
- url: "/numerology/personal-day",
1369
+ url: "/human-design/type",
1336
1370
  ...options,
1337
1371
  headers: {
1338
1372
  "Content-Type": "application/json",
@@ -1341,14 +1375,14 @@ var Numerology = class extends HeyApiClient {
1341
1375
  });
1342
1376
  }
1343
1377
  /**
1344
- * Calculate Personal Month - Monthly numerology forecast
1378
+ * Calculate the 26 Human Design gate activations
1345
1379
  *
1346
- * 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.
1380
+ * 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.
1347
1381
  */
1348
- calculatePersonalMonth(options) {
1382
+ calculateGates(options) {
1349
1383
  return (options?.client ?? this.client).post({
1350
1384
  security: [{ name: "X-API-Key", type: "apiKey" }],
1351
- url: "/numerology/personal-month",
1385
+ url: "/human-design/gates",
1352
1386
  ...options,
1353
1387
  headers: {
1354
1388
  "Content-Type": "application/json",
@@ -1357,30 +1391,26 @@ var Numerology = class extends HeyApiClient {
1357
1391
  });
1358
1392
  }
1359
1393
  /**
1360
- * Calculate Personal Year - Annual cycle and forecast for current year
1394
+ * Look up a Human Design gate by number
1361
1395
  *
1362
- * 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.
1396
+ * 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.
1363
1397
  */
1364
- calculatePersonalYear(options) {
1365
- return (options?.client ?? this.client).post({
1398
+ getGate(options) {
1399
+ return (options.client ?? this.client).get({
1366
1400
  security: [{ name: "X-API-Key", type: "apiKey" }],
1367
- url: "/numerology/personal-year",
1368
- ...options,
1369
- headers: {
1370
- "Content-Type": "application/json",
1371
- ...options?.headers
1372
- }
1401
+ url: "/human-design/gates/{number}",
1402
+ ...options
1373
1403
  });
1374
1404
  }
1375
1405
  /**
1376
- * Calculate Compatibility - Relationship dynamics between two people
1406
+ * Calculate the defined Human Design channels
1377
1407
  *
1378
- * 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.
1408
+ * 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.
1379
1409
  */
1380
- calculateNumCompatibility(options) {
1410
+ calculateChannels(options) {
1381
1411
  return (options?.client ?? this.client).post({
1382
1412
  security: [{ name: "X-API-Key", type: "apiKey" }],
1383
- url: "/numerology/compatibility",
1413
+ url: "/human-design/channels",
1384
1414
  ...options,
1385
1415
  headers: {
1386
1416
  "Content-Type": "application/json",
@@ -1389,14 +1419,14 @@ var Numerology = class extends HeyApiClient {
1389
1419
  });
1390
1420
  }
1391
1421
  /**
1392
- * Generate Complete Numerology Chart - Full profile analysis
1422
+ * Calculate the nine Human Design centers
1393
1423
  *
1394
- * 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.
1424
+ * 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.
1395
1425
  */
1396
- generateNumerologyChart(options) {
1426
+ calculateCenters(options) {
1397
1427
  return (options?.client ?? this.client).post({
1398
1428
  security: [{ name: "X-API-Key", type: "apiKey" }],
1399
- url: "/numerology/chart",
1429
+ url: "/human-design/centers",
1400
1430
  ...options,
1401
1431
  headers: {
1402
1432
  "Content-Type": "application/json",
@@ -1405,26 +1435,26 @@ var Numerology = class extends HeyApiClient {
1405
1435
  });
1406
1436
  }
1407
1437
  /**
1408
- * Get Number Meaning - Interpretation for any number 1-9, 11, 22, 33
1438
+ * Look up a Human Design center by id
1409
1439
  *
1410
- * 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.
1440
+ * 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.
1411
1441
  */
1412
- getNumberMeaning(options) {
1442
+ getCenter(options) {
1413
1443
  return (options.client ?? this.client).get({
1414
1444
  security: [{ name: "X-API-Key", type: "apiKey" }],
1415
- url: "/numerology/meanings/{number}",
1445
+ url: "/human-design/centers/{id}",
1416
1446
  ...options
1417
1447
  });
1418
1448
  }
1419
1449
  /**
1420
- * Get daily numerology number - Number of the Day with interpretation
1450
+ * Calculate the Human Design profile and line keynotes
1421
1451
  *
1422
- * 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.
1452
+ * 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.
1423
1453
  */
1424
- getDailyNumber(options) {
1454
+ calculateProfile(options) {
1425
1455
  return (options?.client ?? this.client).post({
1426
1456
  security: [{ name: "X-API-Key", type: "apiKey" }],
1427
- url: "/numerology/daily",
1457
+ url: "/human-design/profile",
1428
1458
  ...options,
1429
1459
  headers: {
1430
1460
  "Content-Type": "application/json",
@@ -1433,14 +1463,14 @@ var Numerology = class extends HeyApiClient {
1433
1463
  });
1434
1464
  }
1435
1465
  /**
1436
- * Chaldean numerology name reading - Destiny, compound number, planetary ruler
1466
+ * Calculate Human Design Variables - The four arrows and Color, Tone, Base substructure
1437
1467
  *
1438
- * 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.
1468
+ * 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.
1439
1469
  */
1440
- calculateChaldean(options) {
1470
+ calculateVariables(options) {
1441
1471
  return (options?.client ?? this.client).post({
1442
1472
  security: [{ name: "X-API-Key", type: "apiKey" }],
1443
- url: "/numerology/chaldean",
1473
+ url: "/human-design/variables",
1444
1474
  ...options,
1445
1475
  headers: {
1446
1476
  "Content-Type": "application/json",
@@ -1448,27 +1478,17 @@ var Numerology = class extends HeyApiClient {
1448
1478
  }
1449
1479
  });
1450
1480
  }
1481
+ };
1482
+ var Numerology = class extends HeyApiClient {
1451
1483
  /**
1452
- * Compound number meaning - Cheiro Chaldean interpretation 10 to 52
1453
- *
1454
- * 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.
1455
- */
1456
- getCompoundNumber(options) {
1457
- return (options.client ?? this.client).get({
1458
- security: [{ name: "X-API-Key", type: "apiKey" }],
1459
- url: "/numerology/compound-number/{number}",
1460
- ...options
1461
- });
1462
- }
1463
- /**
1464
- * Dual numerology - Pythagorean and Chaldean name numbers in one call
1484
+ * Calculate Life Path number - Most important numerology calculation
1465
1485
  *
1466
- * 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.
1486
+ * 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.
1467
1487
  */
1468
- calculateDual(options) {
1488
+ calculateLifePath(options) {
1469
1489
  return (options?.client ?? this.client).post({
1470
1490
  security: [{ name: "X-API-Key", type: "apiKey" }],
1471
- url: "/numerology/dual",
1491
+ url: "/numerology/life-path",
1472
1492
  ...options,
1473
1493
  headers: {
1474
1494
  "Content-Type": "application/json",
@@ -1477,14 +1497,14 @@ var Numerology = class extends HeyApiClient {
1477
1497
  });
1478
1498
  }
1479
1499
  /**
1480
- * Business name numerology - Chaldean brand name analysis and lucky numbers
1500
+ * Calculate Expression number - Natural talents and life goals
1481
1501
  *
1482
- * 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.
1502
+ * 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.
1483
1503
  */
1484
- calculateBusinessName(options) {
1504
+ calculateExpression(options) {
1485
1505
  return (options?.client ?? this.client).post({
1486
1506
  security: [{ name: "X-API-Key", type: "apiKey" }],
1487
- url: "/numerology/business-name",
1507
+ url: "/numerology/expression",
1488
1508
  ...options,
1489
1509
  headers: {
1490
1510
  "Content-Type": "application/json",
@@ -1492,57 +1512,47 @@ var Numerology = class extends HeyApiClient {
1492
1512
  }
1493
1513
  });
1494
1514
  }
1495
- };
1496
- var Tarot = class extends HeyApiClient {
1497
1515
  /**
1498
- * List all 78 tarot cards
1499
- *
1500
- * 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.
1501
- */
1502
- listCards(options) {
1503
- return (options?.client ?? this.client).get({
1504
- security: [{ name: "X-API-Key", type: "apiKey" }],
1505
- url: "/tarot/cards",
1506
- ...options
1507
- });
1508
- }
1509
- /**
1510
- * Get detailed tarot card information
1516
+ * Calculate Bridge Numbers - Harmonize different aspects of personality
1511
1517
  *
1512
- * 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.
1518
+ * 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.
1513
1519
  */
1514
- getCard(options) {
1515
- return (options.client ?? this.client).get({
1520
+ calculateBridgeNumbers(options) {
1521
+ return (options?.client ?? this.client).post({
1516
1522
  security: [{ name: "X-API-Key", type: "apiKey" }],
1517
- url: "/tarot/cards/{id}",
1518
- ...options
1523
+ url: "/numerology/bridge",
1524
+ ...options,
1525
+ headers: {
1526
+ "Content-Type": "application/json",
1527
+ ...options?.headers
1528
+ }
1519
1529
  });
1520
1530
  }
1521
1531
  /**
1522
- * Draw random tarot cards with reproducible results
1532
+ * Calculate Soul Urge number - Inner motivations and desires
1523
1533
  *
1524
- * 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).
1534
+ * 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.
1525
1535
  */
1526
- drawCards(options) {
1527
- return (options.client ?? this.client).post({
1536
+ calculateSoulUrge(options) {
1537
+ return (options?.client ?? this.client).post({
1528
1538
  security: [{ name: "X-API-Key", type: "apiKey" }],
1529
- url: "/tarot/draw",
1539
+ url: "/numerology/soul-urge",
1530
1540
  ...options,
1531
1541
  headers: {
1532
1542
  "Content-Type": "application/json",
1533
- ...options.headers
1543
+ ...options?.headers
1534
1544
  }
1535
1545
  });
1536
1546
  }
1537
1547
  /**
1538
- * Get daily tarot card reading
1548
+ * Calculate Personality number - How others perceive you
1539
1549
  *
1540
- * 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.
1550
+ * 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.
1541
1551
  */
1542
- getDailyCard(options) {
1552
+ calculatePersonality(options) {
1543
1553
  return (options?.client ?? this.client).post({
1544
1554
  security: [{ name: "X-API-Key", type: "apiKey" }],
1545
- url: "/tarot/daily",
1555
+ url: "/numerology/personality",
1546
1556
  ...options,
1547
1557
  headers: {
1548
1558
  "Content-Type": "application/json",
@@ -1551,112 +1561,110 @@ var Tarot = class extends HeyApiClient {
1551
1561
  });
1552
1562
  }
1553
1563
  /**
1554
- * Get yes/no answer to your question
1564
+ * Calculate Birth Day number - Special talents from day of birth
1555
1565
  *
1556
- * 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.
1566
+ * 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.
1557
1567
  */
1558
- castYesNo(options) {
1559
- return (options.client ?? this.client).post({
1568
+ calculateBirthDay(options) {
1569
+ return (options?.client ?? this.client).post({
1560
1570
  security: [{ name: "X-API-Key", type: "apiKey" }],
1561
- url: "/tarot/yes-no",
1571
+ url: "/numerology/birth-day",
1562
1572
  ...options,
1563
1573
  headers: {
1564
1574
  "Content-Type": "application/json",
1565
- ...options.headers
1575
+ ...options?.headers
1566
1576
  }
1567
1577
  });
1568
1578
  }
1569
1579
  /**
1570
- * Three-Card Spread: Past, Present, Future
1580
+ * Calculate Maturity number - Who you become in later life
1571
1581
  *
1572
- * 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.
1582
+ * 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.
1573
1583
  */
1574
- castThreeCard(options) {
1575
- return (options.client ?? this.client).post({
1584
+ calculateMaturity(options) {
1585
+ return (options?.client ?? this.client).post({
1576
1586
  security: [{ name: "X-API-Key", type: "apiKey" }],
1577
- url: "/tarot/spreads/three-card",
1587
+ url: "/numerology/maturity",
1578
1588
  ...options,
1579
1589
  headers: {
1580
1590
  "Content-Type": "application/json",
1581
- ...options.headers
1591
+ ...options?.headers
1582
1592
  }
1583
1593
  });
1584
1594
  }
1585
1595
  /**
1586
- * Celtic Cross Spread (10 cards)
1596
+ * Analyze Karmic Lessons - Life lessons from missing numbers
1587
1597
  *
1588
- * 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.
1598
+ * 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.
1589
1599
  */
1590
- castCelticCross(options) {
1591
- return (options.client ?? this.client).post({
1600
+ analyzeKarmicLessons(options) {
1601
+ return (options?.client ?? this.client).post({
1592
1602
  security: [{ name: "X-API-Key", type: "apiKey" }],
1593
- url: "/tarot/spreads/celtic-cross",
1603
+ url: "/numerology/karmic-lessons",
1594
1604
  ...options,
1595
1605
  headers: {
1596
1606
  "Content-Type": "application/json",
1597
- ...options.headers
1607
+ ...options?.headers
1598
1608
  }
1599
1609
  });
1600
1610
  }
1601
1611
  /**
1602
- * Love Spread (5 cards)
1612
+ * Detect Karmic Debt numbers - Past life challenges (13, 14, 16, 19)
1603
1613
  *
1604
- * 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.
1614
+ * 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.
1605
1615
  */
1606
- castLoveSpread(options) {
1607
- return (options.client ?? this.client).post({
1616
+ checkKarmicDebt(options) {
1617
+ return (options?.client ?? this.client).post({
1608
1618
  security: [{ name: "X-API-Key", type: "apiKey" }],
1609
- url: "/tarot/spreads/love",
1619
+ url: "/numerology/karmic-debt",
1610
1620
  ...options,
1611
1621
  headers: {
1612
1622
  "Content-Type": "application/json",
1613
- ...options.headers
1623
+ ...options?.headers
1614
1624
  }
1615
1625
  });
1616
1626
  }
1617
1627
  /**
1618
- * Career Spread (7 cards)
1628
+ * Calculate Personal Day - Daily personalized numerology forecast
1619
1629
  *
1620
- * 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.
1630
+ * 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.
1621
1631
  */
1622
- castCareerSpread(options) {
1623
- return (options.client ?? this.client).post({
1632
+ calculatePersonalDay(options) {
1633
+ return (options?.client ?? this.client).post({
1624
1634
  security: [{ name: "X-API-Key", type: "apiKey" }],
1625
- url: "/tarot/spreads/career",
1635
+ url: "/numerology/personal-day",
1626
1636
  ...options,
1627
1637
  headers: {
1628
1638
  "Content-Type": "application/json",
1629
- ...options.headers
1639
+ ...options?.headers
1630
1640
  }
1631
1641
  });
1632
1642
  }
1633
1643
  /**
1634
- * Custom Spread Builder
1644
+ * Calculate Personal Month - Monthly numerology forecast
1635
1645
  *
1636
- * 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.
1646
+ * 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.
1637
1647
  */
1638
- castCustomSpread(options) {
1639
- return (options.client ?? this.client).post({
1648
+ calculatePersonalMonth(options) {
1649
+ return (options?.client ?? this.client).post({
1640
1650
  security: [{ name: "X-API-Key", type: "apiKey" }],
1641
- url: "/tarot/spreads/custom",
1651
+ url: "/numerology/personal-month",
1642
1652
  ...options,
1643
1653
  headers: {
1644
1654
  "Content-Type": "application/json",
1645
- ...options.headers
1655
+ ...options?.headers
1646
1656
  }
1647
1657
  });
1648
1658
  }
1649
- };
1650
- var HumanDesign = class extends HeyApiClient {
1651
1659
  /**
1652
- * Generate full Human Design bodygraph - Type, authority, profile, centers, channels, gates
1660
+ * Calculate Personal Year - Annual cycle and forecast for current year
1653
1661
  *
1654
- * 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.
1662
+ * 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.
1655
1663
  */
1656
- generateBodygraph(options) {
1664
+ calculatePersonalYear(options) {
1657
1665
  return (options?.client ?? this.client).post({
1658
1666
  security: [{ name: "X-API-Key", type: "apiKey" }],
1659
- url: "/human-design/bodygraph",
1667
+ url: "/numerology/personal-year",
1660
1668
  ...options,
1661
1669
  headers: {
1662
1670
  "Content-Type": "application/json",
@@ -1665,14 +1673,14 @@ var HumanDesign = class extends HeyApiClient {
1665
1673
  });
1666
1674
  }
1667
1675
  /**
1668
- * Calculate Human Design connection chart - Two-person composite bodygraph compatibility
1676
+ * Calculate Compatibility - Relationship dynamics between two people
1669
1677
  *
1670
- * 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.
1678
+ * 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.
1671
1679
  */
1672
- calculateConnection(options) {
1680
+ calculateNumCompatibility(options) {
1673
1681
  return (options?.client ?? this.client).post({
1674
1682
  security: [{ name: "X-API-Key", type: "apiKey" }],
1675
- url: "/human-design/connection",
1683
+ url: "/numerology/compatibility",
1676
1684
  ...options,
1677
1685
  headers: {
1678
1686
  "Content-Type": "application/json",
@@ -1681,14 +1689,14 @@ var HumanDesign = class extends HeyApiClient {
1681
1689
  });
1682
1690
  }
1683
1691
  /**
1684
- * Calculate Human Design Penta - Small-group BG5 operating system for three to five people
1692
+ * Generate Complete Numerology Chart - Full profile analysis
1685
1693
  *
1686
- * 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.
1694
+ * 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.
1687
1695
  */
1688
- calculatePenta(options) {
1696
+ generateNumerologyChart(options) {
1689
1697
  return (options?.client ?? this.client).post({
1690
1698
  security: [{ name: "X-API-Key", type: "apiKey" }],
1691
- url: "/human-design/penta",
1699
+ url: "/numerology/chart",
1692
1700
  ...options,
1693
1701
  headers: {
1694
1702
  "Content-Type": "application/json",
@@ -1697,30 +1705,26 @@ var HumanDesign = class extends HeyApiClient {
1697
1705
  });
1698
1706
  }
1699
1707
  /**
1700
- * Generate Human Design transit overlay - Current planetary activations on a natal bodygraph
1708
+ * Get Number Meaning - Interpretation for any number 1-9, 11, 22, 33
1701
1709
  *
1702
- * 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.
1710
+ * 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.
1703
1711
  */
1704
- generateTransit(options) {
1705
- return (options?.client ?? this.client).post({
1712
+ getNumberMeaning(options) {
1713
+ return (options.client ?? this.client).get({
1706
1714
  security: [{ name: "X-API-Key", type: "apiKey" }],
1707
- url: "/human-design/transit",
1708
- ...options,
1709
- headers: {
1710
- "Content-Type": "application/json",
1711
- ...options?.headers
1712
- }
1715
+ url: "/numerology/meanings/{number}",
1716
+ ...options
1713
1717
  });
1714
1718
  }
1715
1719
  /**
1716
- * Calculate Human Design type, authority and profile
1720
+ * Get daily numerology number - Number of the Day with interpretation
1717
1721
  *
1718
- * 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.
1722
+ * 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.
1719
1723
  */
1720
- calculateType(options) {
1724
+ getDailyNumber(options) {
1721
1725
  return (options?.client ?? this.client).post({
1722
1726
  security: [{ name: "X-API-Key", type: "apiKey" }],
1723
- url: "/human-design/type",
1727
+ url: "/numerology/daily",
1724
1728
  ...options,
1725
1729
  headers: {
1726
1730
  "Content-Type": "application/json",
@@ -1729,14 +1733,14 @@ var HumanDesign = class extends HeyApiClient {
1729
1733
  });
1730
1734
  }
1731
1735
  /**
1732
- * Calculate the 26 Human Design gate activations
1736
+ * Chaldean numerology name reading - Destiny, compound number, planetary ruler
1733
1737
  *
1734
- * 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.
1738
+ * 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.
1735
1739
  */
1736
- calculateGates(options) {
1740
+ calculateChaldean(options) {
1737
1741
  return (options?.client ?? this.client).post({
1738
1742
  security: [{ name: "X-API-Key", type: "apiKey" }],
1739
- url: "/human-design/gates",
1743
+ url: "/numerology/chaldean",
1740
1744
  ...options,
1741
1745
  headers: {
1742
1746
  "Content-Type": "application/json",
@@ -1745,26 +1749,26 @@ var HumanDesign = class extends HeyApiClient {
1745
1749
  });
1746
1750
  }
1747
1751
  /**
1748
- * Look up a Human Design gate by number
1752
+ * Compound number meaning - Cheiro Chaldean interpretation 10 to 52
1749
1753
  *
1750
- * 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.
1754
+ * 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.
1751
1755
  */
1752
- getGate(options) {
1756
+ getCompoundNumber(options) {
1753
1757
  return (options.client ?? this.client).get({
1754
1758
  security: [{ name: "X-API-Key", type: "apiKey" }],
1755
- url: "/human-design/gates/{number}",
1759
+ url: "/numerology/compound-number/{number}",
1756
1760
  ...options
1757
1761
  });
1758
1762
  }
1759
1763
  /**
1760
- * Calculate the defined Human Design channels
1764
+ * Dual numerology - Pythagorean and Chaldean name numbers in one call
1761
1765
  *
1762
- * 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.
1766
+ * 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.
1763
1767
  */
1764
- calculateChannels(options) {
1768
+ calculateDual(options) {
1765
1769
  return (options?.client ?? this.client).post({
1766
1770
  security: [{ name: "X-API-Key", type: "apiKey" }],
1767
- url: "/human-design/channels",
1771
+ url: "/numerology/dual",
1768
1772
  ...options,
1769
1773
  headers: {
1770
1774
  "Content-Type": "application/json",
@@ -1773,14 +1777,14 @@ var HumanDesign = class extends HeyApiClient {
1773
1777
  });
1774
1778
  }
1775
1779
  /**
1776
- * Calculate the nine Human Design centers
1780
+ * Business name numerology - Chaldean brand name analysis and lucky numbers
1777
1781
  *
1778
- * 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.
1782
+ * 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.
1779
1783
  */
1780
- calculateCenters(options) {
1784
+ calculateBusinessName(options) {
1781
1785
  return (options?.client ?? this.client).post({
1782
1786
  security: [{ name: "X-API-Key", type: "apiKey" }],
1783
- url: "/human-design/centers",
1787
+ url: "/numerology/business-name",
1784
1788
  ...options,
1785
1789
  headers: {
1786
1790
  "Content-Type": "application/json",
@@ -1788,43 +1792,57 @@ var HumanDesign = class extends HeyApiClient {
1788
1792
  }
1789
1793
  });
1790
1794
  }
1795
+ };
1796
+ var Tarot = class extends HeyApiClient {
1791
1797
  /**
1792
- * Look up a Human Design center by id
1798
+ * List all 78 tarot cards
1793
1799
  *
1794
- * 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.
1800
+ * 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.
1795
1801
  */
1796
- getCenter(options) {
1802
+ listCards(options) {
1803
+ return (options?.client ?? this.client).get({
1804
+ security: [{ name: "X-API-Key", type: "apiKey" }],
1805
+ url: "/tarot/cards",
1806
+ ...options
1807
+ });
1808
+ }
1809
+ /**
1810
+ * Get detailed tarot card information
1811
+ *
1812
+ * 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.
1813
+ */
1814
+ getCard(options) {
1797
1815
  return (options.client ?? this.client).get({
1798
1816
  security: [{ name: "X-API-Key", type: "apiKey" }],
1799
- url: "/human-design/centers/{id}",
1817
+ url: "/tarot/cards/{id}",
1800
1818
  ...options
1801
1819
  });
1802
1820
  }
1803
1821
  /**
1804
- * Calculate the Human Design profile and line keynotes
1822
+ * Draw random tarot cards with reproducible results
1805
1823
  *
1806
- * 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.
1824
+ * 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).
1807
1825
  */
1808
- calculateProfile(options) {
1809
- return (options?.client ?? this.client).post({
1826
+ drawCards(options) {
1827
+ return (options.client ?? this.client).post({
1810
1828
  security: [{ name: "X-API-Key", type: "apiKey" }],
1811
- url: "/human-design/profile",
1829
+ url: "/tarot/draw",
1812
1830
  ...options,
1813
1831
  headers: {
1814
1832
  "Content-Type": "application/json",
1815
- ...options?.headers
1833
+ ...options.headers
1816
1834
  }
1817
1835
  });
1818
1836
  }
1819
1837
  /**
1820
- * Calculate Human Design Variables - The four arrows and Color, Tone, Base substructure
1838
+ * Get daily tarot card reading
1821
1839
  *
1822
- * 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.
1840
+ * 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.
1823
1841
  */
1824
- calculateVariables(options) {
1842
+ getDailyCard(options) {
1825
1843
  return (options?.client ?? this.client).post({
1826
1844
  security: [{ name: "X-API-Key", type: "apiKey" }],
1827
- url: "/human-design/variables",
1845
+ url: "/tarot/daily",
1828
1846
  ...options,
1829
1847
  headers: {
1830
1848
  "Content-Type": "application/json",
@@ -1832,85 +1850,99 @@ var HumanDesign = class extends HeyApiClient {
1832
1850
  }
1833
1851
  });
1834
1852
  }
1835
- };
1836
- var Forecast = class extends HeyApiClient {
1837
1853
  /**
1838
- * Cross-domain forecast timeline - Transits, ingresses, stations, dasha changes, critical days
1854
+ * Get yes/no answer to your question
1839
1855
  *
1840
- * 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.
1856
+ * 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.
1841
1857
  */
1842
- generateTimeline(options) {
1843
- return (options?.client ?? this.client).post({
1858
+ castYesNo(options) {
1859
+ return (options.client ?? this.client).post({
1844
1860
  security: [{ name: "X-API-Key", type: "apiKey" }],
1845
- url: "/forecast/timeline",
1861
+ url: "/tarot/yes-no",
1846
1862
  ...options,
1847
1863
  headers: {
1848
1864
  "Content-Type": "application/json",
1849
- ...options?.headers
1865
+ ...options.headers
1850
1866
  }
1851
1867
  });
1852
1868
  }
1853
1869
  /**
1854
- * Western astrology forecast - aspects, ingresses, stations, eclipses, moon phases
1870
+ * Three-Card Spread: Past, Present, Future
1855
1871
  *
1856
- * 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.
1872
+ * 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.
1857
1873
  */
1858
- forecastTransits(options) {
1859
- return (options?.client ?? this.client).post({
1874
+ castThreeCard(options) {
1875
+ return (options.client ?? this.client).post({
1860
1876
  security: [{ name: "X-API-Key", type: "apiKey" }],
1861
- url: "/forecast/transits",
1877
+ url: "/tarot/spreads/three-card",
1862
1878
  ...options,
1863
1879
  headers: {
1864
1880
  "Content-Type": "application/json",
1865
- ...options?.headers
1881
+ ...options.headers
1866
1882
  }
1867
1883
  });
1868
1884
  }
1869
1885
  /**
1870
- * Significant dates - High-significance cross-domain forecast highlights
1886
+ * Celtic Cross Spread (10 cards)
1871
1887
  *
1872
- * 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.
1888
+ * 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.
1873
1889
  */
1874
- findSignificantDates(options) {
1875
- return (options?.client ?? this.client).post({
1890
+ castCelticCross(options) {
1891
+ return (options.client ?? this.client).post({
1876
1892
  security: [{ name: "X-API-Key", type: "apiKey" }],
1877
- url: "/forecast/significant-dates",
1893
+ url: "/tarot/spreads/celtic-cross",
1878
1894
  ...options,
1879
1895
  headers: {
1880
1896
  "Content-Type": "application/json",
1881
- ...options?.headers
1897
+ ...options.headers
1882
1898
  }
1883
1899
  });
1884
1900
  }
1885
1901
  /**
1886
- * Forecast digest - Pre-summarized next 24h, 7d, 30d, and 90d rollups
1902
+ * Love Spread (5 cards)
1887
1903
  *
1888
- * 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.
1904
+ * 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.
1889
1905
  */
1890
- generateDigest(options) {
1891
- return (options?.client ?? this.client).post({
1906
+ castLoveSpread(options) {
1907
+ return (options.client ?? this.client).post({
1892
1908
  security: [{ name: "X-API-Key", type: "apiKey" }],
1893
- url: "/forecast/digest",
1909
+ url: "/tarot/spreads/love",
1894
1910
  ...options,
1895
1911
  headers: {
1896
1912
  "Content-Type": "application/json",
1897
- ...options?.headers
1913
+ ...options.headers
1898
1914
  }
1899
1915
  });
1900
1916
  }
1901
1917
  /**
1902
- * Solar return chart - Annual birthday forecast chart for a single subject
1918
+ * Career Spread (7 cards)
1903
1919
  *
1904
- * 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.
1920
+ * 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.
1905
1921
  */
1906
- forecastSolarReturn(options) {
1907
- return (options?.client ?? this.client).post({
1922
+ castCareerSpread(options) {
1923
+ return (options.client ?? this.client).post({
1908
1924
  security: [{ name: "X-API-Key", type: "apiKey" }],
1909
- url: "/forecast/solar-return",
1925
+ url: "/tarot/spreads/career",
1910
1926
  ...options,
1911
1927
  headers: {
1912
1928
  "Content-Type": "application/json",
1913
- ...options?.headers
1929
+ ...options.headers
1930
+ }
1931
+ });
1932
+ }
1933
+ /**
1934
+ * Custom Spread Builder
1935
+ *
1936
+ * 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.
1937
+ */
1938
+ castCustomSpread(options) {
1939
+ return (options.client ?? this.client).post({
1940
+ security: [{ name: "X-API-Key", type: "apiKey" }],
1941
+ url: "/tarot/spreads/custom",
1942
+ ...options,
1943
+ headers: {
1944
+ "Content-Type": "application/json",
1945
+ ...options.headers
1914
1946
  }
1915
1947
  });
1916
1948
  }
@@ -2481,6 +2513,14 @@ var Roxy = class _Roxy extends HeyApiClient {
2481
2513
  get vedicAstrology() {
2482
2514
  return this._vedicAstrology ??= new VedicAstrology({ client: this.client });
2483
2515
  }
2516
+ _forecast;
2517
+ get forecast() {
2518
+ return this._forecast ??= new Forecast({ client: this.client });
2519
+ }
2520
+ _humanDesign;
2521
+ get humanDesign() {
2522
+ return this._humanDesign ??= new HumanDesign({ client: this.client });
2523
+ }
2484
2524
  _numerology;
2485
2525
  get numerology() {
2486
2526
  return this._numerology ??= new Numerology({ client: this.client });
@@ -2489,14 +2529,6 @@ var Roxy = class _Roxy extends HeyApiClient {
2489
2529
  get tarot() {
2490
2530
  return this._tarot ??= new Tarot({ client: this.client });
2491
2531
  }
2492
- _humanDesign;
2493
- get humanDesign() {
2494
- return this._humanDesign ??= new HumanDesign({ client: this.client });
2495
- }
2496
- _forecast;
2497
- get forecast() {
2498
- return this._forecast ??= new Forecast({ client: this.client });
2499
- }
2500
2532
  _biorhythm;
2501
2533
  get biorhythm() {
2502
2534
  return this._biorhythm ??= new Biorhythm({ client: this.client });
@@ -2532,7 +2564,7 @@ var Roxy = class _Roxy extends HeyApiClient {
2532
2564
  };
2533
2565
 
2534
2566
  // src/version.ts
2535
- var VERSION = "1.2.48";
2567
+ var VERSION = "1.2.50";
2536
2568
 
2537
2569
  // src/factory.ts
2538
2570
  function createRoxy(auth) {