sweph 2.10.3-5 → 2.10.3-6

package/README.md

@@ -38,8 +38,8 @@ This library is version locked to the Swiss Ephemeris in addition to its own rev
 
 Updates to this library will be released under new revisions, while updates to Swiss Ephemeris will be released under matching SemVer versions.
 
-**Current Version: 2.10.3-b-1**  
-**Equivalent to Swiss Ephemeris version: 2.10.03b revision 1**
+**Current Version: 2.10.3-6**  
+**Equivalent to Swiss Ephemeris version: 2.10.03 revision 6**
 
 ## Documentation
 
@@ -49,7 +49,7 @@ This library is fully typed and documented via intellisense. To access its docum
 
 ## Ephemeris files
 
-Ephemeris files are required to enable high precision calculations for planets and asteroids. This library does not include any ephemeris files by default, but you can download them from the official Swiss Ephemeris Github repository (main planets only) or the official Astrodienst Dropox folder (all files):
+Ephemeris files are required to enable high precision calculations for planets and asteroids. This library does not include any ephemeris files by default, but you can download them from the official Swiss Ephemeris Github repository (main planets only) or the official Astrodienst Dropbox folder (all files):
 
 * Swiss Ephemeris Github: [https://github.com/aloistr/swisseph/tree/master/ephe](https://github.com/aloistr/swisseph/tree/master/ephe)
 * Astrodienst Dropbox [https://www.dropbox.com/scl/fo/y3naz62gy6f6qfrhquu7u/h?rlkey=ejltdhb262zglm7eo6yfj2940&dl=0](https://www.dropbox.com/scl/fo/y3naz62gy6f6qfrhquu7u/h?rlkey=ejltdhb262zglm7eo6yfj2940&dl=0)
@@ -82,10 +82,10 @@ If you find any inaccuracy or bug in this library, or if you find an upstream up
 
 * While worker_threads are supported, the underlying C library is single threaded and contains process-wide settings. Functions such as `set_ephe_path()` or `set_sid_mode()` will affect the entire process, including all worker_threads. While you can still use worker_threads as long as you don't change settings from other threads in the middle of calculations, true thread-safe multithreading can only be achieved using child_process.
 
-* This library is a C/C++ add-on designed for Node.JS only, it will not work in browsers, other JS engines or in any other environment that does not support native C/C++ add-ons made with Node's N-API. In order to install this library, the target system must have the necessary build tools installed, such as `python`, `make` and `gcc` on Linux, `xcode` on Mac, `visual c++ build tools` on Windows, and/or other equivalent solutions.
+* This library is a C/C++ add-on designed for Node.JS only, it will not work in browsers, other JS engines or in any other environment that does not support native C/C++ add-ons made with Node's N-API. Prebuilt binaries are included for supported platforms. If no matching prebuild is available for the target system, installation falls back to a native build and requires the necessary build tools, such as `python`, `make` and `gcc` on Linux, `xcode` on Mac, `visual c++ build tools` on Windows, and/or other equivalent solutions.
 
 ## Copyright
 
-Copyright © 2021-2023, Timotej Valentin Rojko
+Copyright © 2021-2026, Timotej Valentin Rojko
 
-This library is offered free of charge for any type of use, including commercial use, however, if you're an individual or a company using this library in commercial products and/or services, consider subscribing to the appropriate sponsorship level [here](https://github.com/sponsors/timotejroiko) and get priority support for your business.
+This library is offered free of charge for any type of use, including commercial use. If you rely on it in personal or commercial projects, consider sponsoring the project to help fund maintenance, updates, and support.

package/index.d.ts

@@ -2098,13 +2098,13 @@ declare module "sweph" {
 	 * ```
 	 * string
 	 * ```
-	 * ### Example
-	 * ```
-	 * const time = cs2timestr(2345464, ":", true); // "6:30:55"
-	 * ```
-	 *  
-	 */
-	export function cs2timestr(csec: number, sep: string, suppresszero: boolean): string;
+	 * ### Example
+	 * ```
+	 * const time = cs2timestr(2345464, ":", true); // "06:30:55"
+	 * ```
+	 *  
+	 */
+	export function cs2timestr(csec: number, sep: string, suppresszero: boolean): string;
 
 	/**
 	 * ### Description
@@ -2242,15 +2242,16 @@ declare module "sweph" {
 	 * Object {
 	 *   error: string // Warning message if any
 	 *   data: number // Delta T value
-	 * }
-	 * ```
-	 * ### Example
-	 * ```
-	 * const deltaT = deltat_ex(2431232, constants.SEFLG_MOSEPH); // 0.00032552915335235926
-	 * ```
-	 *  
-	 */
-	export function deltat_ex(tjd: number, ephe: number): DeltaT;
+	 * }
+	 * ```
+	 * ### Example
+	 * ```
+	 * const result = deltat_ex(2431232, constants.SEFLG_MOSEPH);
+	 * console.log(result.data); // 0.0003093125751840641
+	 * ```
+	 *  
+	 */
+	export function deltat_ex(tjd: number, ephe: number): DeltaT;
 
 	/**
 	 * ### Description
@@ -2261,15 +2262,15 @@ declare module "sweph" {
 	 * ```
 	 * ### Returns
 	 * ```
-	 * number // Delta T value
-	 * ```
-	 * ### Example
-	 * ```
-	 * const deltaT = deltat(2431232); // 0.00032554160173271644
-	 * ```
-	 *  
-	 */
-	export function deltat(tjd: number): number;
+	 * number // Delta T value
+	 * ```
+	 * ### Example
+	 * ```
+	 * const deltaT = deltat(2431232); // 0.0003093386847061279
+	 * ```
+	 *  
+	 */
+	export function deltat(tjd: number): number;
 
 	/**
 	 * ### Description
@@ -2333,7 +2334,67 @@ declare module "sweph" {
 
 	/**
 	 * ### Description
-	 * Arc distance between two points in degrees in a single direction
+	 * Arc distance between two points in radians normalized to the range -PI to PI
+	 * ### Params
+	 * ```
+	 * • rad1: number // First point in radians
+	 * • rad2: number // Second point in radians
+	 * ```
+	 * ### Returns
+	 * ```
+	 * number // Distance in radians from -PI to PI
+	 * ```
+	 * ### Example
+	 * ```
+	 * const distance = difrad2n(Math.PI / 2, 0); // 1.5707963267948966
+	 * ```
+	 *  
+	 */
+	export function difrad2n(rad1: number, rad2: number): number;
+
+	/**
+	 * ### Description
+	 * Midpoint between two points in degrees
+	 * ### Params
+	 * ```
+	 * • deg1: number // First point in degrees
+	 * • deg2: number // Second point in degrees
+	 * ```
+	 * ### Returns
+	 * ```
+	 * number // Midpoint in degrees
+	 * ```
+	 * ### Example
+	 * ```
+	 * const mid = deg_midp(10, 350); // 0
+	 * ```
+	 *  
+	 */
+	export function deg_midp(deg1: number, deg2: number): number;
+
+	/**
+	 * ### Description
+	 * Midpoint between two points in radians
+	 * ### Params
+	 * ```
+	 * • rad1: number // First point in radians
+	 * • rad2: number // Second point in radians
+	 * ```
+	 * ### Returns
+	 * ```
+	 * number // Midpoint in radians
+	 * ```
+	 * ### Example
+	 * ```
+	 * const mid = rad_midp(0.1, 6.2); // 0.00840734641020724
+	 * ```
+	 *  
+	 */
+	export function rad_midp(rad1: number, rad2: number): number;
+
+	/**
+	 * ### Description
+	 * Arc distance between two points in degrees in a single direction
 	 * ### Params
 	 * ```
 	 * • deg1: number // First point in degrees
@@ -2365,15 +2426,15 @@ declare module "sweph" {
 	 *   error: string, // Error message in case of ERR
 	 *   name: string, // The name of the matched star from the sefstars.txt file
 	 *   data: number // The star's magnitude value
-	 * }
-	 * ```
-	 * ### Example
-	 * ```
-	 * const result = fixStar_mag("Aldebaran");
-	 * if(result.flag !== constants.OK) { throw new Error(result.error); }
-	 * console.log(`
-	 *   Star: ${result.name}
-	 *   Magnitude: ${result.data}
+	 * }
+	 * ```
+	 * ### Example
+	 * ```
+	 * const result = fixstar_mag("Aldebaran");
+	 * if(result.flag !== constants.OK) { throw new Error(result.error); }
+	 * console.log(`
+	 *   Star: ${result.name}
+	 *   Magnitude: ${result.data}
 	 * `)
 	 * ```
 	 *  
@@ -2474,15 +2535,15 @@ declare module "sweph" {
 	 *   error: string, // Error message in case of ERR
 	 *   name: string, // The name of the matched star from the sefstars.txt file
 	 *   data: number // The star's magnitude value
-	 * }
-	 * ```
-	 * ### Example
-	 * ```
-	 * const result = fixStar2_mag("Aldebaran");
-	 * if(result.flag !== constants.OK) { throw new Error(result.error); }
-	 * console.log(`
-	 *   Star: ${result.name}
-	 *   Magnitude: ${result.data}
+	 * }
+	 * ```
+	 * ### Example
+	 * ```
+	 * const result = fixstar2_mag("Aldebaran");
+	 * if(result.flag !== constants.OK) { throw new Error(result.error); }
+	 * console.log(`
+	 *   Star: ${result.name}
+	 *   Magnitude: ${result.data}
 	 * `)
 	 * ```
 	 *  
@@ -3302,16 +3363,16 @@ declare module "sweph" {
 	 *   hour: number; // Hour (0-23)
 	 *   minute: number; // Minute (0-59)
 	 *   second: number; // Second including fraction (0-59.99999)
-	 * }
-	 * ```
-	 * ### Example
-	 * ```
-	 * const date = jdet_to_utc(2415423, constants.GREG_CAL);
-	 * console.log(date);
-	 * ```
-	 *  
-	 */
-	export function jdet_to_utc(tjd_et: number, gregflag: number): DateObject2;
+	 * }
+	 * ```
+	 * ### Example
+	 * ```
+	 * const date = jdet_to_utc(2415423, constants.SE_GREG_CAL);
+	 * console.log(date);
+	 * ```
+	 *  
+	 */
+	export function jdet_to_utc(tjd_et: number, gregflag: number): DateObject2;
 
 	/**
 	 * ### Description
@@ -3330,16 +3391,16 @@ declare module "sweph" {
 	 *   hour: number; // Hour (0-23)
 	 *   minute: number; // Minute (0-59)
 	 *   second: number; // Second including fraction (0-59.99999)
-	 * }
-	 * ```
-	 * ### Example
-	 * ```
-	 * const date = jdut1_to_utc(2415423, constants.GREG_CAL);
-	 * console.log(date);
-	 * ```
-	 *  
-	 */
-	export function jdut1_to_utc(tjd_ut: number, gregflag: number): DateObject2;
+	 * }
+	 * ```
+	 * ### Example
+	 * ```
+	 * const date = jdut1_to_utc(2415423, constants.SE_GREG_CAL);
+	 * console.log(date);
+	 * ```
+	 *  
+	 */
+	export function jdut1_to_utc(tjd_ut: number, gregflag: number): DateObject2;
 
 	/**
 	 * ### Description
@@ -4052,9 +4113,9 @@ declare module "sweph" {
 	 */
 	export function radnorm(drad: number): number;
 
-	/**
-	 * ### Description
-	 * Calculate true altitude from the apparent altitude or apparent altitude from true altitude  
+	/**
+	 * ### Description
+	 * Calculate true altitude from the apparent altitude or apparent altitude from true altitude  
 	 * Extended function also supports negative heights and more
 	 * ### Params
 	 * ```
@@ -4188,17 +4249,17 @@ declare module "sweph" {
 	 *   flag: number, // OK, ERR or -2 if circumpolar object
 	 *   error: string, // Error message if any
 	 *   data: number // Transit time in julian days in universal time
-	 * }
-	 * ```
-	 * ### Example
-	 * ```
-	 * const result = rise_trans_true_hor(2555555, constants.SE_MOON, null, constants.SEFLG_SWIEPH, constants.SE_CALC_RISE, [95,40,200], 0, 0);
-	 * if(result.flag !== constants.OK) { console.log(result.error); }
-	 * console.log(result.data);
-	 * ```
-	 *  
-	 */
-	export function rise_trans(tjd_ut: number, ipl: number, starname: string | null, epheflag: number, rsmi: number, geopos: [longitude: number, latitude: number, elevation: number], atpress: number, attemp: number): RiseTrans;
+	 * }
+	 * ```
+	 * ### Example
+	 * ```
+	 * const result = rise_trans(2555555, constants.SE_MOON, null, constants.SEFLG_SWIEPH, constants.SE_CALC_RISE, [95,40,200], 0, 0);
+	 * if(result.flag !== constants.OK) { console.log(result.error); }
+	 * console.log(result.data);
+	 * ```
+	 *  
+	 */
+	export function rise_trans(tjd_ut: number, ipl: number, starname: string | null, epheflag: number, rsmi: number, geopos: [longitude: number, latitude: number, elevation: number], atpress: number, attemp: number): RiseTrans;
 
 	/**
 	 * ### Description
@@ -4293,6 +4354,21 @@ declare module "sweph" {
 	 */
 	export function set_tid_acc(t_acc: number): void;
 
+	/**
+	 * ### Description
+	 * Set the atmospheric lapse rate used by the extended refraction calculations
+	 * ### Params
+	 * ```
+	 * • lapse_rate: number // Lapse rate [°K/m]
+	 * ```
+	 * ### Example
+	 * ```
+	 * set_lapse_rate(0.0065);
+	 * ```
+	 *  
+	 */
+	export function set_lapse_rate(lapse_rate: number): void;
+
 	/**
 	 * ### Description
 	 * Set geographic coordinates for topocentric mode
@@ -4725,15 +4801,15 @@ declare module "sweph" {
 	 * Get current swisseph version
 	 * ### Returns
 	 * ```
-	 * string // Swisseph version
-	 * ```
-	 * ### Example
-	 * ```
-	 * const version = version(); // "2.10"
-	 * ```
-	 *  
-	 */
-	export function version(): string;
+	 * string // Swisseph version
+	 * ```
+	 * ### Example
+	 * ```
+	 * const currentVersion = version(); // "2.10.03"
+	 * ```
+	 *  
+	 */
+	export function version(): string;
 
 	/**
 	 * ### Description

package/index.mjs

@@ -21,6 +21,7 @@ export const close = s.close;
 export const set_delta_t_userdef = s.set_delta_t_userdef;
 export const set_ephe_path = s.set_ephe_path;
 export const set_jpl_file = s.set_jpl_file;
+export const set_lapse_rate = s.set_lapse_rate;
 export const set_sid_mode = s.set_sid_mode;
 export const set_tid_acc = s.set_tid_acc;
 export const set_topo = s.set_topo;
@@ -100,6 +101,9 @@ export const difcsn = s.difcsn;
 export const difdegn = s.difdegn;
 export const difcs2n = s.difcs2n;
 export const difdeg2n = s.difdeg2n;
+export const difrad2n = s.difrad2n;
+export const deg_midp = s.deg_midp;
+export const rad_midp = s.rad_midp;
 export const csroundsec = s.csroundsec;
 export const d2l = s.d2l;
 export const day_of_week = s.day_of_week;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "sweph",
-	"version": "2.10.3-5",
+	"version": "2.10.3-6",
 	"description": "The definitive Swiss Ephemeris bindings for Node.js",
 	"keywords": [
 		"sweph",
@@ -47,7 +47,7 @@
 		"prebuild": "prebuildify --napi --strip"
 	},
 	"dependencies": {
-		"node-addon-api": "^8.7.0",
+		"node-addon-api": "^8.9.0",
 		"node-gyp-build": "^4.8.4"
 	},
 	"devDependencies": {

package/src/functions/deg_midp.cpp

@@ -0,0 +1,19 @@
+#include <sweph.h>
+
+constexpr std::pair<int, const char*> args[] = {
+	{ 2, "Expecting 2 arguments: deg1, deg2" },
+	{ NUMBER, "Argument 1 should be a number - first point in degrees" },
+	{ NUMBER, "Argument 2 should be a number - second point in degrees" }
+};
+
+Napi::Value sweph_deg_midp(const Napi::CallbackInfo& info) {
+	Napi::Env env = info.Env();
+	if(!sweph_type_check(args, info)) {
+		return env.Null();
+	}
+	double mid = swe_deg_midp(
+		info[0].As<Napi::Number>().DoubleValue(),
+		info[1].As<Napi::Number>().DoubleValue()
+	);
+	return Napi::Number::New(env, mid);
+}

package/src/functions/difrad2n.cpp

@@ -0,0 +1,19 @@
+#include <sweph.h>
+
+constexpr std::pair<int, const char*> args[] = {
+	{ 2, "Expecting 2 arguments: rad, rad" },
+	{ NUMBER, "Argument 1 should be a number - radians" },
+	{ NUMBER, "Argument 2 should be a number - radians" }
+};
+
+Napi::Value sweph_difrad2n(const Napi::CallbackInfo& info) {
+	Napi::Env env = info.Env();
+	if(!sweph_type_check(args, info)) {
+		return env.Null();
+	}
+	double dif = swe_difrad2n(
+		info[0].As<Napi::Number>().DoubleValue(),
+		info[1].As<Napi::Number>().DoubleValue()
+	);
+	return Napi::Number::New(env, dif);
+}

package/src/functions/rad_midp.cpp

@@ -0,0 +1,19 @@
+#include <sweph.h>
+
+constexpr std::pair<int, const char*> args[] = {
+	{ 2, "Expecting 2 arguments: rad1, rad2" },
+	{ NUMBER, "Argument 1 should be a number - first point in radians" },
+	{ NUMBER, "Argument 2 should be a number - second point in radians" }
+};
+
+Napi::Value sweph_rad_midp(const Napi::CallbackInfo& info) {
+	Napi::Env env = info.Env();
+	if(!sweph_type_check(args, info)) {
+		return env.Null();
+	}
+	double mid = swe_rad_midp(
+		info[0].As<Napi::Number>().DoubleValue(),
+		info[1].As<Napi::Number>().DoubleValue()
+	);
+	return Napi::Number::New(env, mid);
+}

package/src/functions/set_lapse_rate.cpp

@@ -0,0 +1,14 @@
+#include <sweph.h>
+
+constexpr std::pair<int, const char*> args[] = {
+	{ 1, "Expecting 1 arguments: lapse_rate" },
+	{ NUMBER, "Argument 1 should be a number - lapse rate [°K/m]" }
+};
+
+void sweph_set_lapse_rate(const Napi::CallbackInfo& info) {
+	if(!sweph_type_check(args, info)) {
+		return;
+	}
+	swe_set_lapse_rate(info[0].As<Napi::Number>().DoubleValue());
+	return;
+}

package/src/sweph.cpp

@@ -5,6 +5,7 @@ Napi::Object Init(Napi::Env env, Napi::Object exports) {
 	exports["set_delta_t_userdef"] = Napi::Function::New(env, sweph_set_delta_t_userdef);
 	exports["set_ephe_path"] = Napi::Function::New(env, sweph_set_ephe_path);
 	exports["set_jpl_file"] = Napi::Function::New(env, sweph_set_jpl_file);
+	exports["set_lapse_rate"] = Napi::Function::New(env, sweph_set_lapse_rate);
 	exports["set_sid_mode"] = Napi::Function::New(env, sweph_set_sid_mode);
 	exports["set_tid_acc"] = Napi::Function::New(env, sweph_set_tid_acc);
 	exports["set_topo"] = Napi::Function::New(env, sweph_set_topo);
@@ -84,6 +85,9 @@ Napi::Object Init(Napi::Env env, Napi::Object exports) {
 	exports["difdegn"] = Napi::Function::New(env, sweph_difdegn);
 	exports["difcs2n"] = Napi::Function::New(env, sweph_difcs2n);
 	exports["difdeg2n"] = Napi::Function::New(env, sweph_difdeg2n);
+	exports["difrad2n"] = Napi::Function::New(env, sweph_difrad2n);
+	exports["deg_midp"] = Napi::Function::New(env, sweph_deg_midp);
+	exports["rad_midp"] = Napi::Function::New(env, sweph_rad_midp);
 	exports["csroundsec"] = Napi::Function::New(env, sweph_csroundsec);
 	exports["d2l"] = Napi::Function::New(env, sweph_d2l);
 	exports["day_of_week"] = Napi::Function::New(env, sweph_day_of_week);

package/src/sweph.h

@@ -9,6 +9,7 @@ void sweph_close(const Napi::CallbackInfo& info);
 void sweph_set_delta_t_userdef(const Napi::CallbackInfo& info);
 void sweph_set_ephe_path(const Napi::CallbackInfo& info);
 void sweph_set_jpl_file(const Napi::CallbackInfo& info);
+void sweph_set_lapse_rate(const Napi::CallbackInfo& info);
 void sweph_set_sid_mode(const Napi::CallbackInfo& info);
 void sweph_set_tid_acc(const Napi::CallbackInfo& info);
 void sweph_set_topo(const Napi::CallbackInfo& info);
@@ -88,6 +89,9 @@ Napi::Value sweph_difcsn(const Napi::CallbackInfo& info);
 Napi::Value sweph_difcs2n(const Napi::CallbackInfo& info);
 Napi::Value sweph_difdegn(const Napi::CallbackInfo& info);
 Napi::Value sweph_difdeg2n(const Napi::CallbackInfo& info);
+Napi::Value sweph_difrad2n(const Napi::CallbackInfo& info);
+Napi::Value sweph_deg_midp(const Napi::CallbackInfo& info);
+Napi::Value sweph_rad_midp(const Napi::CallbackInfo& info);
 Napi::Value sweph_csroundsec(const Napi::CallbackInfo& info);
 Napi::Value sweph_d2l(const Napi::CallbackInfo& info);
 Napi::Value sweph_day_of_week(const Napi::CallbackInfo& info);
@@ -116,4 +120,4 @@ enum TYPES {
 	TRUEFALSE
 };
 
-#endif 
+#endif