@swisseph/node 1.0.5 → 1.1.0

package/README.md

@@ -6,14 +6,21 @@ High precision astronomical calculations for Node.js using native bindings to th
 
 ```bash
 npm install @swisseph/node
+# or
+pnpm add @swisseph/node
+# or
+bun add @swisseph/node
 ```
 
 **Requirements:**
-- Node.js 14.0.0 or higher
-- C++ build tools for native compilation
+- Node.js 14.0.0 or higher (or Bun)
+
+**Prebuilt binaries are included** for common platforms (macOS, Linux, Windows). No C++ compiler needed for most users.
 
 <details>
-<summary>Installing build tools</summary>
+<summary>Building from source (optional)</summary>
+
+If prebuilt binaries aren't available for your platform, the package will automatically build from source. You'll need C++ build tools:
 
 **macOS:**
 ```bash
@@ -35,7 +42,7 @@ npm install --global windows-build-tools
 
 ```typescript
 import {
-  julianDay,
+  dateToJulianDay,
   calculatePosition,
   calculateHouses,
   Planet,
@@ -44,8 +51,9 @@ import {
 
 // No setup required! Ephemeris files are bundled and auto-loaded.
 
-// Calculate planetary position
-const jd = julianDay(2007, 3, 3);
+// Calculate planetary position using Date object
+const date = new Date('2007-03-03T00:00:00Z');
+const jd = dateToJulianDay(date);
 const sun = calculatePosition(jd, Planet.Sun);
 console.log(`Sun: ${sun.longitude}°`);
 
@@ -60,10 +68,28 @@ console.log(`MC: ${houses.mc}°`);
 ### Date & Time
 
 ```typescript
+// Convert JavaScript Date to Julian day (recommended)
+dateToJulianDay(date, calendarType?)
+
+// Convert date components to Julian day
 julianDay(year, month, day, hour?, calendarType?)
+
+// Convert Julian day back to date
 julianDayToDate(jd, calendarType?)
 ```
 
+**Examples:**
+```typescript
+// Using Date object (easiest)
+const jd = dateToJulianDay(new Date('1990-05-15T14:30:00Z'));
+
+// Using date components
+const jd2 = julianDay(1990, 5, 15, 14.5);  // Same result
+
+// Current time
+const now = dateToJulianDay(new Date());
+```
+
 ### Planetary Positions
 
 ```typescript
@@ -140,7 +166,7 @@ import {
 
 ```typescript
 import {
-  julianDay,
+  dateToJulianDay,
   calculatePosition,
   calculateHouses,
   Planet,
@@ -149,7 +175,8 @@ import {
 } from '@swisseph/node';
 
 // Birth: May 15, 1990, 14:30 UTC, New York (40.7128°N, 74.0060°W)
-const jd = julianDay(1990, 5, 15, 14.5);
+const birthDate = new Date('1990-05-15T14:30:00Z');
+const jd = dateToJulianDay(birthDate);
 
 // Calculate all planet positions
 const planets = [
@@ -213,9 +240,10 @@ close();
 ### Planetary Aspects
 
 ```typescript
-import { julianDay, calculatePosition, Planet, close } from '@swisseph/node';
+import { dateToJulianDay, calculatePosition, Planet, close } from '@swisseph/node';
 
-const jd = julianDay(2025, 6, 15);
+// Calculate for current time
+const jd = dateToJulianDay(new Date());
 
 // Calculate positions
 const sun = calculatePosition(jd, Planet.Sun);
@@ -253,16 +281,21 @@ Complete documentation is available in the [GitHub repository](https://github.co
 
 ## Troubleshooting
 
+**"Module did not self-register" or platform errors**
+- The package includes prebuilt binaries for common platforms
+- If your platform isn't supported, the package will try to build from source
+- Install C++ build tools if needed (see "Building from source" above)
+- Try rebuilding: `npm rebuild @swisseph/node`
+
 **Build fails with "node-gyp rebuild failed"**
-- Install C++ build tools (see installation section above)
+- Install C++ build tools (see "Building from source" section above)
+- On macOS: ensure Xcode Command Line Tools are installed
+- On Windows: ensure Visual Studio Build Tools are installed
 
 **"Cannot find ephemeris files"**
 - Files are bundled with the package. Check `node_modules/@swisseph/node/ephemeris/` exists
 - If using custom files, verify path in `setEphemerisPath()`
 
-**"Module did not self-register"**
-- Rebuild for your Node.js version: `npm rebuild @swisseph/node`
-
 ## License
 
 AGPL-3.0 (same as Swiss Ephemeris)

package/dist/index.d.ts

@@ -42,6 +42,29 @@ export declare function setEphemerisPath(path?: string | null): void;
  * console.log(jdWithTime); // 2454163.104166667
  */
 export declare function julianDay(year: number, month: number, day: number, hour?: number, calendarType?: CalendarType): number;
+/**
+ * Calculate Julian day number from a JavaScript Date object
+ *
+ * Convenience function that converts a JavaScript Date to Julian day number.
+ * The Date is interpreted as UTC.
+ *
+ * @param date - JavaScript Date object (interpreted as UTC)
+ * @param calendarType - Calendar system (default: Gregorian)
+ * @returns Julian day number
+ *
+ * @example
+ * // From Date object
+ * const date = new Date('1990-05-15T14:30:00Z');
+ * const jd = dateToJulianDay(date);
+ *
+ * // From timestamp
+ * const now = new Date();
+ * const jdNow = dateToJulianDay(now);
+ *
+ * // Equivalent to julianDay(1990, 5, 15, 14.5)
+ * const jd2 = dateToJulianDay(new Date(Date.UTC(1990, 4, 15, 14, 30)));
+ */
+export declare function dateToJulianDay(date: Date, calendarType?: CalendarType): number;
 /**
  * Convert Julian day number to calendar date
  *

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EAEZ,aAAa,EACb,WAAW,EAEX,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,YAAY,EAEZ,gBAAgB,EAQjB,MAAM,gBAAgB,CAAC;AAkCxB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAU3D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAU,EAChB,YAAY,GAAE,YAAqC,GAClD,MAAM,CAER;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EACV,YAAY,GAAE,YAAqC,GAClD,gBAAgB,CAGlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,EACnB,KAAK,GAAE,oBAAmE,GACzE,iBAAiB,CAenB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,GAAE,WAAkC,GAC9C,SAAS,CAmBX;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,oBAAqD,EAC5D,WAAW,GAAE,oBAAwB,EACrC,QAAQ,GAAE,OAAe,GACxB,YAAY,CAwBd;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,oBAAqD,EAC5D,WAAW,GAAE,oBAAwB,EACrC,QAAQ,GAAE,OAAe,GACxB,YAAY,CAwBd;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAEhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAGD,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,YAAY,EAEZ,aAAa,EACb,WAAW,EAEX,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,YAAY,EAEZ,gBAAgB,EAQjB,MAAM,gBAAgB,CAAC;AAkCxB;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAU3D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAU,EAChB,YAAY,GAAE,YAAqC,GAClD,MAAM,CAER;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,EACV,YAAY,GAAE,YAAqC,GAClD,MAAM,CAaR;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EACV,YAAY,GAAE,YAAqC,GAClD,gBAAgB,CAGlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,EACnB,KAAK,GAAE,oBAAmE,GACzE,iBAAiB,CAenB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,GAAE,WAAkC,GAC9C,SAAS,CAmBX;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,oBAAqD,EAC5D,WAAW,GAAE,oBAAwB,EACrC,QAAQ,GAAE,OAAe,GACxB,YAAY,CAwBd;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,MAAM,EACtB,KAAK,GAAE,oBAAqD,EAC5D,WAAW,GAAE,oBAAwB,EACrC,QAAQ,GAAE,OAAe,GACxB,YAAY,CAwBd;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAEhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AAGD,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -44,6 +44,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setEphemerisPath = setEphemerisPath;
 exports.julianDay = julianDay;
+exports.dateToJulianDay = dateToJulianDay;
 exports.julianDayToDate = julianDayToDate;
 exports.calculatePosition = calculatePosition;
 exports.calculateHouses = calculateHouses;
@@ -128,6 +129,40 @@ function setEphemerisPath(path) {
 function julianDay(year, month, day, hour = 0, calendarType = core_1.CalendarType.Gregorian) {
     return binding.julday(year, month, day, hour, calendarType);
 }
+/**
+ * Calculate Julian day number from a JavaScript Date object
+ *
+ * Convenience function that converts a JavaScript Date to Julian day number.
+ * The Date is interpreted as UTC.
+ *
+ * @param date - JavaScript Date object (interpreted as UTC)
+ * @param calendarType - Calendar system (default: Gregorian)
+ * @returns Julian day number
+ *
+ * @example
+ * // From Date object
+ * const date = new Date('1990-05-15T14:30:00Z');
+ * const jd = dateToJulianDay(date);
+ *
+ * // From timestamp
+ * const now = new Date();
+ * const jdNow = dateToJulianDay(now);
+ *
+ * // Equivalent to julianDay(1990, 5, 15, 14.5)
+ * const jd2 = dateToJulianDay(new Date(Date.UTC(1990, 4, 15, 14, 30)));
+ */
+function dateToJulianDay(date, calendarType = core_1.CalendarType.Gregorian) {
+    const year = date.getUTCFullYear();
+    const month = date.getUTCMonth() + 1; // JavaScript months are 0-indexed
+    const day = date.getUTCDate();
+    const hours = date.getUTCHours();
+    const minutes = date.getUTCMinutes();
+    const seconds = date.getUTCSeconds();
+    const milliseconds = date.getUTCMilliseconds();
+    // Convert to decimal hours
+    const decimalHours = hours + minutes / 60 + seconds / 3600 + milliseconds / 3600000;
+    return julianDay(year, month, day, decimalHours, calendarType);
+}
 /**
  * Convert Julian day number to calendar date
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swisseph/node",
-  "version": "1.0.5",
+  "version": "1.1.0",
   "description": "Swiss Ephemeris for Node.js - high precision astronomical calculations with native bindings",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",