@roxyapi/sdk 1.2.55 → 1.2.57

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.2.55";
+export declare const VERSION = "1.2.57";
 //# sourceMappingURL=version.d.ts.map

package/docs/llms-full.txt

@@ -155,6 +155,8 @@ const { data } = await roxy.astrology.calculateTransitAspects({
     },
     transitDate: '2026-02-03',
     transitTime: '12:00:00',
+    planets: ['Jupiter', 'Saturn', 'Pluto'],
+    aspectTypes: ['CONJUNCTION', 'OPPOSITION', 'TRINE', 'SQUARE'],
     minStrength: 50,
   },
 });
@@ -398,7 +400,10 @@ const { data } = await roxy.vedicAstrology.generateBirthChart({
     latitude: 28.6139,
     longitude: 77.209,
     timezone: 5.5,
+    ayanamsa: 'lahiri',
+    ayanamsaValue: 24,
     avasthaInfo: true,
+    modernPlanets: true,
   },
 });
 
@@ -410,6 +415,8 @@ const { data } = await roxy.vedicAstrology.generateNavamsa({
     latitude: 28.6139,
     longitude: 77.209,
     timezone: 5.5,
+    ayanamsa: 'lahiri',
+    ayanamsaValue: 24,
   },
 });
 
@@ -421,6 +428,8 @@ const { data } = await roxy.vedicAstrology.generateDivisionalChart({
     latitude: 28.6139,
     longitude: 77.209,
     timezone: 5.5,
+    ayanamsa: 'lahiri',
+    ayanamsaValue: 24,
     division: 10,
   },
 });
@@ -442,6 +451,8 @@ const { data } = await roxy.vedicAstrology.calculateGunMilan({
       longitude: 77.209,
       timezone: 5.5,
     },
+    ayanamsa: 'lahiri',
+    ayanamsaValue: 24,
   },
 });
 
@@ -453,6 +464,8 @@ const { data } = await roxy.vedicAstrology.getPlanetPositions({
     latitude: 28.6139,
     longitude: 77.209,
     timezone: 5.5,
+    ayanamsa: 'lahiri',
+    ayanamsaValue: 24,
   },
 });
 
@@ -619,6 +632,8 @@ const { data } = await roxy.vedicAstrology.checkManglikDosha({
     latitude: 28.6139,
     longitude: 77.209,
     timezone: 5.5,
+    ayanamsa: 'lahiri',
+    ayanamsaValue: 24,
   },
 });
 
@@ -630,6 +645,8 @@ const { data } = await roxy.vedicAstrology.checkKalsarpaDosha({
     latitude: 28.6139,
     longitude: 77.209,
     timezone: 5.5,
+    ayanamsa: 'lahiri',
+    ayanamsaValue: 24,
   },
 });
 
@@ -641,6 +658,8 @@ const { data } = await roxy.vedicAstrology.checkSadhesati({
     latitude: 28.6139,
     longitude: 77.209,
     timezone: 5.5,
+    ayanamsa: 'lahiri',
+    ayanamsaValue: 24,
   },
 });
 
@@ -658,6 +677,8 @@ const { data } = await roxy.vedicAstrology.detectYogas({
     latitude: 28.6139,
     longitude: 77.209,
     timezone: 5.5,
+    ayanamsa: 'lahiri',
+    ayanamsaValue: 24,
   },
 });
 
@@ -780,6 +801,22 @@ const { data } = await roxy.vedicAstrology.getKpPlanetsInterval({
   },
 });
 
+// Cast a KP horary (Prashna) chart from a number 1-249 - KP Horary API
+const { data } = await roxy.vedicAstrology.castKpHoraryChart({
+  query: { focus: 'general' },
+  body: {
+    horaryNumber: 108,
+    date: '2026-03-08',
+    time: '14:30:00',
+    latitude: 19.076,
+    longitude: 72.8777,
+    timezone: 5.5,
+    ayanamsa: 'kp-newcomb',
+    ayanamsaValue: 24,
+    nodeType: 'mean',
+  },
+});
+
 // Get planetary aspects (Drishti) - Mutual aspects between all planets
 const { data } = await roxy.vedicAstrology.calculateDrishti({
   body: {
@@ -876,6 +913,8 @@ const { data } = await roxy.vedicAstrology.getUpagrahaPositions({
     latitude: 28.6139,
     longitude: 77.209,
     timezone: 5.5,
+    ayanamsa: 'lahiri',
+    ayanamsaValue: 24,
   },
 });
 
@@ -887,6 +926,8 @@ const { data } = await roxy.vedicAstrology.calculateAshtakavarga({
     latitude: 28.6139,
     longitude: 77.209,
     timezone: 5.5,
+    ayanamsa: 'lahiri',
+    ayanamsaValue: 24,
   },
 });
 
@@ -898,6 +939,8 @@ const { data } = await roxy.vedicAstrology.calculateShadbala({
     latitude: 28.6139,
     longitude: 77.209,
     timezone: 5.5,
+    ayanamsa: 'lahiri',
+    ayanamsaValue: 24,
   },
 });
 
@@ -915,6 +958,8 @@ const { data } = await roxy.vedicAstrology.calculateArudhaPadas({
     latitude: 28.6139,
     longitude: 77.209,
     timezone: 5.5,
+    ayanamsa: 'lahiri',
+    ayanamsaValue: 24,
   },
 });
 
@@ -926,9 +971,49 @@ const { data } = await roxy.vedicAstrology.calculateCharaKarakas({
     latitude: 28.6139,
     longitude: 77.209,
     timezone: 5.5,
+    ayanamsa: 'lahiri',
+    ayanamsaValue: 24,
     scheme: 'eight',
   },
 });
+
+// Get Bhava Bala (house strength) for all twelve houses - Bhava Bala Calculator API
+const { data } = await roxy.vedicAstrology.calculateBhavaBala({
+  query: { focus: 'general' },
+  body: {
+    date: '1990-07-04',
+    time: '10:12:00',
+    latitude: 28.6139,
+    longitude: 77.209,
+    timezone: 5.5,
+    ayanamsa: 'lahiri',
+    ayanamsaValue: 24,
+  },
+});
+
+// Get the Bhav Chalit (Chalit Kundli) cusp-based house chart - Bhav Chalit API
+const { data } = await roxy.vedicAstrology.calculateBhavChalit({
+  query: { focus: 'general' },
+  body: {
+    date: '1990-07-04',
+    time: '10:12:00',
+    latitude: 28.6139,
+    longitude: 77.209,
+    timezone: 5.5,
+    ayanamsa: 'lahiri',
+    ayanamsaValue: 24,
+  },
+});
+
+// Heliacal rising and setting (udaya and asta) - Graha Asta Calculator API
+const { data } = await roxy.vedicAstrology.getHeliacalVisibility({
+  body: {
+    date: '2026-07-25',
+    latitude: 19.076,
+    longitude: 72.8777,
+    timezone: 5.5,
+  },
+});
 ```
 
 ---
@@ -1332,7 +1417,7 @@ const { data } = await roxy.tarot.getDailyCard({ body: { seed: 'user123', date:
 const { data } = await roxy.tarot.castYesNo({
   body: {
     question: 'Should I accept the job offer?',
-    seed: 'optional-seed',
+    seed: 'reading-2f9c1a',
   },
 });
 
@@ -1340,7 +1425,7 @@ const { data } = await roxy.tarot.castYesNo({
 const { data } = await roxy.tarot.castThreeCard({
   body: {
     question: 'What do I need to know about my career?',
-    seed: 'optional-seed',
+    seed: 'reading-2f9c1a',
   },
 });
 
@@ -1348,7 +1433,7 @@ const { data } = await roxy.tarot.castThreeCard({
 const { data } = await roxy.tarot.castCelticCross({
   body: {
     question: 'What should I know about this situation?',
-    seed: 'optional-seed',
+    seed: 'reading-2f9c1a',
   },
 });
 
@@ -1356,7 +1441,7 @@ const { data } = await roxy.tarot.castCelticCross({
 const { data } = await roxy.tarot.castLoveSpread({
   body: {
     question: 'What do I need to know about my relationship?',
-    seed: 'optional-seed',
+    seed: 'reading-2f9c1a',
   },
 });
 
@@ -1364,7 +1449,7 @@ const { data } = await roxy.tarot.castLoveSpread({
 const { data } = await roxy.tarot.castCareerSpread({
   body: {
     question: 'What do I need to know about my career path?',
-    seed: 'optional-seed',
+    seed: 'reading-2f9c1a',
   },
 });
 
@@ -1383,8 +1468,8 @@ const { data } = await roxy.tarot.castCustomSpread({
       },
       { name: 'Best Action', interpretation: 'What to do next' },
     ],
-    question: 'Optional question',
-    seed: 'optional-seed',
+    question: 'How do I move forward with this project?',
+    seed: 'reading-2f9c1a',
   },
 });
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@roxyapi/sdk",
-	"version": "1.2.55",
+	"version": "1.2.57",
 	"description": "TypeScript SDK for Roxy — the multi-domain spiritual intelligence API",
 	"type": "module",
 	"exports": {
@@ -67,10 +67,10 @@
 		"url": "https://github.com/RoxyAPI/sdk-typescript/issues"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "^2.5.3",
+		"@biomejs/biome": "^2.5.6",
 		"@hey-api/client-fetch": "0.13.1",
-		"@hey-api/openapi-ts": "0.97.3",
-		"@types/node": "^26.1.1",
+		"@hey-api/openapi-ts": "0.99.0",
+		"@types/node": "^26.1.2",
 		"lefthook": "^2.1.10",
 		"tsup": "^8.5.1",
 		"typescript": "^6.0.3",

package/src/client/index.ts

@@ -9,6 +9,8 @@ export {
 } from '../core/bodySerializer.gen';
 export { buildClientParams } from '../core/params.gen';
 export { serializeQueryKeyValue } from '../core/queryKeySerializer.gen';
+export type { ServerSentEventsResult } from '../core/serverSentEvents.gen';
+export type { ClientMeta } from '../core/types.gen';
 export { createClient } from './client.gen';
 export type {
   Client,

package/src/client/utils.gen.ts

@@ -14,8 +14,8 @@ import type { Client, ClientOptions, Config, RequestOptions } from './types.gen'
 export const createQuerySerializer = <T = unknown>({
   parameters = {},
   ...args
-}: QuerySerializerOptions = {}) => {
-  const querySerializer = (queryParams: T) => {
+}: QuerySerializerOptions = {}): ((queryParams: T) => string) => {
+  const querySerializer = (queryParams: T): string => {
     const search: string[] = [];
     if (queryParams && typeof queryParams === 'object') {
       for (const name in queryParams) {

package/src/client.gen.ts

@@ -1,6 +1,6 @@
 // This file is auto-generated by @hey-api/openapi-ts
 
-import { type ClientOptions, type Config, createClient, createConfig } from './client';
+import { type Client, type ClientOptions, type Config, createClient, createConfig } from './client';
 import type { ClientOptions as ClientOptions2 } from './types.gen';
 
 /**
@@ -13,4 +13,4 @@ import type { ClientOptions as ClientOptions2 } from './types.gen';
  */
 export type CreateClientConfig<T extends ClientOptions = ClientOptions2> = (override?: Config<ClientOptions & T>) => Config<Required<ClientOptions> & T>;
 
-export const client = createClient(createConfig<ClientOptions2>({ baseUrl: 'https://roxyapi.com/api/v2' }));
+export const client: Client = createClient(createConfig<ClientOptions2>({ baseUrl: 'https://roxyapi.com/api/v2' }));

package/src/core/auth.gen.ts

@@ -9,6 +9,13 @@ export interface Auth {
    * @default 'header'
    */
   in?: 'header' | 'query' | 'cookie';
+  /**
+   * A unique identifier for the security scheme.
+   *
+   * Defined only when there are multiple security schemes whose `Auth`
+   * shape would otherwise be identical.
+   */
+  key?: string;
   /**
    * Header or query parameter name.
    *

package/src/core/params.gen.ts

@@ -62,7 +62,7 @@ type KeyMap = Map<
     }
 >;
 
-const buildKeyMap = (fields: FieldsConfig, map?: KeyMap): KeyMap => {
+function buildKeyMap(fields: FieldsConfig, map?: KeyMap): KeyMap {
   if (!map) {
     map = new Map();
   }
@@ -85,26 +85,26 @@ const buildKeyMap = (fields: FieldsConfig, map?: KeyMap): KeyMap => {
   }
 
   return map;
-};
+}
 
 interface Params {
-  body: unknown;
+  body?: unknown;
   headers: Record<string, unknown>;
   path: Record<string, unknown>;
   query: Record<string, unknown>;
 }
 
-const stripEmptySlots = (params: Params) => {
+function stripEmptySlots(params: Params): void {
   for (const [slot, value] of Object.entries(params)) {
+    if (slot === 'body') continue;
     if (value && typeof value === 'object' && !Array.isArray(value) && !Object.keys(value).length) {
       delete params[slot as Slot];
     }
   }
-};
+}
 
-export const buildClientParams = (args: ReadonlyArray<unknown>, fields: FieldsConfig) => {
+export function buildClientParams(args: ReadonlyArray<unknown>, fields: FieldsConfig): Params {
   const params: Params = {
-    body: Object.create(null),
     headers: Object.create(null),
     path: Object.create(null),
     query: Object.create(null),
@@ -112,6 +112,15 @@ export const buildClientParams = (args: ReadonlyArray<unknown>, fields: FieldsCo
 
   const map = buildKeyMap(fields);
 
+  function writeSlot(slot: Slot, key: string, value: unknown): void {
+    let record = params[slot] as Record<string, unknown> | undefined;
+    if (record === undefined) {
+      record = Object.create(null) as Record<string, unknown>;
+      params[slot] = record;
+    }
+    record[key] = value;
+  }
+
   let config: FieldsConfig[number] | undefined;
 
   for (const [index, arg] of args.entries()) {
@@ -128,7 +137,7 @@ export const buildClientParams = (args: ReadonlyArray<unknown>, fields: FieldsCo
         const field = map.get(config.key)!;
         const name = field.map || config.key;
         if (field.in) {
-          (params[field.in] as Record<string, unknown>)[name] = arg;
+          writeSlot(field.in, name, arg);
         }
       } else {
         params.body = arg;
@@ -140,7 +149,7 @@ export const buildClientParams = (args: ReadonlyArray<unknown>, fields: FieldsCo
         if (field) {
           if (field.in) {
             const name = field.map || key;
-            (params[field.in] as Record<string, unknown>)[name] = value;
+            writeSlot(field.in, name, value);
           } else {
             params[field.map] = value;
           }
@@ -149,11 +158,11 @@ export const buildClientParams = (args: ReadonlyArray<unknown>, fields: FieldsCo
 
           if (extra) {
             const [prefix, slot] = extra;
-            (params[slot] as Record<string, unknown>)[key.slice(prefix.length)] = value;
+            writeSlot(slot, key.slice(prefix.length), value);
           } else if ('allowExtra' in config && config.allowExtra) {
             for (const [slot, allowed] of Object.entries(config.allowExtra)) {
               if (allowed) {
-                (params[slot as Slot] as Record<string, unknown>)[key] = value;
+                writeSlot(slot as Slot, key, value);
                 break;
               }
             }
@@ -166,4 +175,4 @@ export const buildClientParams = (args: ReadonlyArray<unknown>, fields: FieldsCo
   stripEmptySlots(params);
 
   return params;
-};
+}

package/src/core/pathSerializer.gen.ts

@@ -25,7 +25,7 @@ interface SerializePrimitiveParam extends SerializePrimitiveOptions {
   value: string;
 }
 
-export const separatorArrayExplode = (style: ArraySeparatorStyle) => {
+export const separatorArrayExplode = (style: ArraySeparatorStyle): '.' | ';' | ',' | '&' => {
   switch (style) {
     case 'label':
       return '.';
@@ -38,7 +38,7 @@ export const separatorArrayExplode = (style: ArraySeparatorStyle) => {
   }
 };
 
-export const separatorArrayNoExplode = (style: ArraySeparatorStyle) => {
+export const separatorArrayNoExplode = (style: ArraySeparatorStyle): ',' | '|' | '%20' => {
   switch (style) {
     case 'form':
       return ',';
@@ -51,7 +51,7 @@ export const separatorArrayNoExplode = (style: ArraySeparatorStyle) => {
   }
 };
 
-export const separatorObjectExplode = (style: ObjectSeparatorStyle) => {
+export const separatorObjectExplode = (style: ObjectSeparatorStyle): '.' | ';' | ',' | '&' => {
   switch (style) {
     case 'label':
       return '.';
@@ -72,7 +72,7 @@ export const serializeArrayParam = ({
   value,
 }: SerializeOptions<ArraySeparatorStyle> & {
   value: unknown[];
-}) => {
+}): string => {
   if (!explode) {
     const joinedValues = (
       allowReserved ? value : value.map((v) => encodeURIComponent(v as string))
@@ -110,7 +110,7 @@ export const serializePrimitiveParam = ({
   allowReserved,
   name,
   value,
-}: SerializePrimitiveParam) => {
+}: SerializePrimitiveParam): string => {
   if (value === undefined || value === null) {
     return '';
   }
@@ -134,7 +134,7 @@ export const serializeObjectParam = ({
 }: SerializeOptions<ObjectSeparatorStyle> & {
   value: Record<string, unknown> | Date;
   valueOnly?: boolean;
-}) => {
+}): string => {
   if (value instanceof Date) {
     return valueOnly ? value.toISOString() : `${name}=${value.toISOString()}`;
   }

package/src/core/queryKeySerializer.gen.ts

@@ -14,7 +14,7 @@ export type JsonValue =
 /**
  * Replacer that converts non-JSON values (bigint, Date, etc.) to safe substitutes.
  */
-export const queryKeyJsonReplacer = (_key: string, value: unknown) => {
+export const queryKeyJsonReplacer = (_key: string, value: unknown): unknown | undefined => {
   if (value === undefined || typeof value === 'function' || typeof value === 'symbol') {
     return undefined;
   }

package/src/core/types.gen.ts

@@ -91,6 +91,12 @@ export interface Config {
   responseValidator?: (data: unknown) => Promise<unknown>;
 }
 
+/**
+ * Arbitrary metadata passed through the `meta` request option.
+ */
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
+export interface ClientMeta {}
+
 type IsExactlyNeverOrNeverUndefined<T> = [T] extends [never]
   ? true
   : [T] extends [never | undefined]

package/src/core/utils.gen.ts

@@ -13,9 +13,9 @@ export interface PathSerializer {
   url: string;
 }
 
-export const PATH_PARAM_RE = /\{[^{}]+\}/g;
+export const PATH_PARAM_RE: RegExp = /\{[^{}]+\}/g;
 
-export const defaultPathSerializer = ({ path, url: _url }: PathSerializer) => {
+export const defaultPathSerializer = ({ path, url: _url }: PathSerializer): string => {
   let url = _url;
   const matches = _url.match(PATH_PARAM_RE);
   if (matches) {
@@ -94,7 +94,7 @@ export const getUrl = ({
   query?: Record<string, unknown>;
   querySerializer: QuerySerializer;
   url: string;
-}) => {
+}): string => {
   const pathUrl = _url.startsWith('/') ? _url : `/${_url}`;
   let url = (baseUrl ?? '') + pathUrl;
   if (path) {
@@ -114,7 +114,7 @@ export function getValidRequestBody(options: {
   body?: unknown;
   bodySerializer?: BodySerializer | null;
   serializedBody?: unknown;
-}) {
+}): unknown {
   const hasBody = options.body !== undefined;
   const isSerializedBody = hasBody && options.bodySerializer;