@astro-api/n8n-nodes-astrology 0.2.0 → 0.3.0

package/README.md

@@ -25,8 +25,14 @@ Official n8n community node for [Astrology API](https://astrology-api.io) — pr
 
 ### Charts & Visualization
 - **Natal Charts** — Birth chart generation with SVG output
-- **Transit Charts** — Current planetary transits overlay
-- **Synastry** — Relationship compatibility analysis
+- **Transit Charts** — Current planetary transits overlay on natal chart
+- **Synastry Charts** — Relationship compatibility analysis (cross-aspects)
+- **Composite Charts** — Merged midpoint chart for couples
+- **Solar Return Charts** — Birthday year forecast
+- **Lunar Return Charts** — Monthly forecast based on Moon return
+- **Progressions Charts** — Secondary progressions for life phases
+- **Natal Transits** — Transit analysis over date range
+- **Directions Charts** — Primary directions for timing predictions
 - **Multiple House Systems** — Placidus, Koch, Equal, Whole Sign, and 20+ more
 
 ## Installation
@@ -89,6 +95,14 @@ For Docker deployments, mount the package or use `N8N_CUSTOM_EXTENSIONS`.
 | Personal forecast | Horoscope | Personal Daily/Weekly/Monthly/Yearly | Birth chart-based personalized predictions |
 | Chinese astrology | Horoscope | Chinese Bazi | Four Pillars of Destiny analysis |
 | Birth chart | Charts | Natal | SVG natal chart with configurable house system |
+| Relationship chart | Charts | Synastry | Two-person compatibility analysis (cross-aspects) |
+| Combined chart | Charts | Composite | Merged midpoint chart for couples |
+| Current transits | Charts | Transit | Planetary transits overlay on natal chart |
+| Birthday forecast | Charts | Solar Return | Year-ahead predictions based on Sun return |
+| Monthly forecast | Charts | Lunar Return | Month-ahead predictions based on Moon return |
+| Life phases | Charts | Progressions | Secondary progressions for internal development |
+| Period analysis | Charts | Natal Transits | Transit events over a date range |
+| Timing predictions | Charts | Directions | Primary directions for life event timing |
 
 ### Common Use Cases
 

package/dist/nodes/Astrology/Astrology.node.js

@@ -30,7 +30,7 @@ class Astrology {
             version: 1,
             usableAsTool: true,
             subtitle: '={{$parameter["operation"] + ": " + $parameter["resource"]}}',
-            description: "Professional astrological calculations: planetary positions, house cusps, aspects, lunar metrics, horoscopes, and natal charts using Astrology API",
+            description: "Perform astrological calculations via Astrology API",
             defaults: {
                 name: "Astrology",
             },

package/dist/nodes/Astrology/handlers/charts.handler.js

@@ -2,6 +2,20 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleChartsResource = handleChartsResource;
 const shared_1 = require("../shared");
+/**
+ * Endpoint mapping for chart operations
+ */
+const CHARTS_ENDPOINTS = {
+    natal: "/api/v3/charts/natal",
+    synastry: "/api/v3/charts/synastry",
+    transit: "/api/v3/charts/transit",
+    composite: "/api/v3/charts/composite",
+    solarReturn: "/api/v3/charts/solar-return",
+    lunarReturn: "/api/v3/charts/lunar-return",
+    progressions: "/api/v3/charts/progressions",
+    natalTransits: "/api/v3/charts/natal-transits",
+    directions: "/api/v3/charts/directions",
+};
 /**
  * Active points presets mapping
  */
@@ -119,10 +133,28 @@ const ACTIVE_POINTS_PRESETS = {
  */
 async function handleChartsResource(context, operation) {
     const op = operation;
-    if (op === "natal") {
-        return await handleNatalChart(context);
+    switch (op) {
+        case "natal":
+            return handleNatalChart(context);
+        case "synastry":
+            return handleSynastryChart(context);
+        case "transit":
+            return handleTransitChart(context);
+        case "composite":
+            return handleCompositeChart(context);
+        case "solarReturn":
+            return handleSolarReturnChart(context);
+        case "lunarReturn":
+            return handleLunarReturnChart(context);
+        case "progressions":
+            return handleProgressionsChart(context);
+        case "natalTransits":
+            return handleNatalTransits(context);
+        case "directions":
+            return handleDirectionsChart(context);
+        default:
+            throw new Error(`The operation '${operation}' is not supported for the charts resource`);
     }
-    throw new Error(`The operation '${operation}' is not supported for the charts resource`);
 }
 /**
  * Handles natal chart generation
@@ -199,3 +231,298 @@ async function handleNatalChart(context) {
     const simplify = executeFunctions.getNodeParameter("simplify", itemIndex, true);
     return simplify ? (0, shared_1.simplifyResponse)(responseData) : responseData;
 }
+/**
+ * Builds second subject birth data from subject2* prefixed fields
+ */
+function buildSecondSubjectBirthData(executeFunctions, itemIndex) {
+    const locationType = executeFunctions.getNodeParameter("subject2LocationType", itemIndex);
+    const birthData = {
+        year: executeFunctions.getNodeParameter("subject2Year", itemIndex),
+        month: executeFunctions.getNodeParameter("subject2Month", itemIndex),
+        day: executeFunctions.getNodeParameter("subject2Day", itemIndex),
+        hour: executeFunctions.getNodeParameter("subject2Hour", itemIndex),
+        minute: executeFunctions.getNodeParameter("subject2Minute", itemIndex),
+    };
+    if (locationType === "city") {
+        birthData.city = executeFunctions.getNodeParameter("subject2City", itemIndex);
+        birthData.country_code = executeFunctions.getNodeParameter("subject2CountryCode", itemIndex);
+    }
+    else {
+        birthData.latitude = executeFunctions.getNodeParameter("subject2Latitude", itemIndex);
+        birthData.longitude = executeFunctions.getNodeParameter("subject2Longitude", itemIndex);
+    }
+    return birthData;
+}
+/**
+ * Builds transit time object from transit* prefixed fields
+ */
+function buildTransitTime(executeFunctions, itemIndex) {
+    const locationType = executeFunctions.getNodeParameter("transitLocationType", itemIndex);
+    const transitTime = {
+        year: executeFunctions.getNodeParameter("transitYear", itemIndex),
+        month: executeFunctions.getNodeParameter("transitMonth", itemIndex),
+        day: executeFunctions.getNodeParameter("transitDay", itemIndex),
+        hour: executeFunctions.getNodeParameter("transitHour", itemIndex),
+        minute: executeFunctions.getNodeParameter("transitMinute", itemIndex),
+    };
+    if (locationType === "city") {
+        transitTime.city = executeFunctions.getNodeParameter("transitCity", itemIndex);
+        transitTime.country_code = executeFunctions.getNodeParameter("transitCountryCode", itemIndex);
+    }
+    else {
+        transitTime.latitude = executeFunctions.getNodeParameter("transitLatitude", itemIndex);
+        transitTime.longitude = executeFunctions.getNodeParameter("transitLongitude", itemIndex);
+    }
+    return transitTime;
+}
+/**
+ * Gets common chart options
+ */
+function getChartOptions(executeFunctions, itemIndex) {
+    const houseSystem = executeFunctions.getNodeParameter("houseSystem", itemIndex);
+    const zodiacType = executeFunctions.getNodeParameter("zodiacType", itemIndex);
+    const perspective = executeFunctions.getNodeParameter("perspective", itemIndex);
+    const precision = executeFunctions.getNodeParameter("precision", itemIndex);
+    const activePointsPreset = executeFunctions.getNodeParameter("activePointsPreset", itemIndex);
+    let activePoints;
+    if (activePointsPreset === "custom") {
+        activePoints = executeFunctions.getNodeParameter("customActivePoints", itemIndex);
+    }
+    else {
+        activePoints =
+            ACTIVE_POINTS_PRESETS[activePointsPreset] || ACTIVE_POINTS_PRESETS.modern;
+    }
+    return {
+        house_system: houseSystem,
+        zodiac_type: zodiacType,
+        active_points: activePoints,
+        precision,
+        perspective,
+    };
+}
+/**
+ * Handles synastry chart generation (two-person relationship chart)
+ */
+async function handleSynastryChart(context) {
+    const { executeFunctions, itemIndex, baseUrl, apiKey } = context;
+    // Build subject 1
+    const birthData1 = (0, shared_1.buildBirthData)(executeFunctions, itemIndex);
+    const subjectName1 = executeFunctions.getNodeParameter("subjectName", itemIndex, "");
+    // Build subject 2
+    const birthData2 = buildSecondSubjectBirthData(executeFunctions, itemIndex);
+    const subjectName2 = executeFunctions.getNodeParameter("subject2Name", itemIndex, "");
+    // Get options
+    const options = getChartOptions(executeFunctions, itemIndex);
+    // Build request body
+    const body = {
+        subject1: {
+            birth_data: birthData1,
+            ...(subjectName1 && { name: subjectName1 }),
+        },
+        subject2: {
+            birth_data: birthData2,
+            ...(subjectName2 && { name: subjectName2 }),
+        },
+        options,
+    };
+    const responseData = await (0, shared_1.makeApiRequest)(executeFunctions, "POST", baseUrl, CHARTS_ENDPOINTS.synastry, apiKey, body);
+    const simplify = executeFunctions.getNodeParameter("simplify", itemIndex, true);
+    return simplify ? (0, shared_1.simplifyResponse)(responseData) : responseData;
+}
+/**
+ * Handles transit chart generation (transits overlay on natal)
+ */
+async function handleTransitChart(context) {
+    const { executeFunctions, itemIndex, baseUrl, apiKey } = context;
+    // Build natal subject
+    const birthData = (0, shared_1.buildBirthData)(executeFunctions, itemIndex);
+    const subjectName = executeFunctions.getNodeParameter("subjectName", itemIndex, "");
+    // Build transit time
+    const transitTime = buildTransitTime(executeFunctions, itemIndex);
+    // Get options
+    const options = getChartOptions(executeFunctions, itemIndex);
+    // Build request body
+    const body = {
+        subject: {
+            birth_data: birthData,
+            ...(subjectName && { name: subjectName }),
+        },
+        transit_time: {
+            datetime: transitTime,
+        },
+        options,
+    };
+    const responseData = await (0, shared_1.makeApiRequest)(executeFunctions, "POST", baseUrl, CHARTS_ENDPOINTS.transit, apiKey, body);
+    const simplify = executeFunctions.getNodeParameter("simplify", itemIndex, true);
+    return simplify ? (0, shared_1.simplifyResponse)(responseData) : responseData;
+}
+/**
+ * Handles composite chart generation (merged relationship chart)
+ */
+async function handleCompositeChart(context) {
+    const { executeFunctions, itemIndex, baseUrl, apiKey } = context;
+    // Build subject 1
+    const birthData1 = (0, shared_1.buildBirthData)(executeFunctions, itemIndex);
+    const subjectName1 = executeFunctions.getNodeParameter("subjectName", itemIndex, "");
+    // Build subject 2
+    const birthData2 = buildSecondSubjectBirthData(executeFunctions, itemIndex);
+    const subjectName2 = executeFunctions.getNodeParameter("subject2Name", itemIndex, "");
+    // Get options
+    const options = getChartOptions(executeFunctions, itemIndex);
+    // Build request body
+    const body = {
+        subject1: {
+            birth_data: birthData1,
+            ...(subjectName1 && { name: subjectName1 }),
+        },
+        subject2: {
+            birth_data: birthData2,
+            ...(subjectName2 && { name: subjectName2 }),
+        },
+        options,
+    };
+    const responseData = await (0, shared_1.makeApiRequest)(executeFunctions, "POST", baseUrl, CHARTS_ENDPOINTS.composite, apiKey, body);
+    const simplify = executeFunctions.getNodeParameter("simplify", itemIndex, true);
+    return simplify ? (0, shared_1.simplifyResponse)(responseData) : responseData;
+}
+/**
+ * Handles solar return chart generation (birthday year forecast)
+ */
+async function handleSolarReturnChart(context) {
+    const { executeFunctions, itemIndex, baseUrl, apiKey } = context;
+    // Build natal subject
+    const birthData = (0, shared_1.buildBirthData)(executeFunctions, itemIndex);
+    const subjectName = executeFunctions.getNodeParameter("subjectName", itemIndex, "");
+    // Get return year
+    const returnYear = executeFunctions.getNodeParameter("returnYear", itemIndex);
+    // Get options
+    const options = getChartOptions(executeFunctions, itemIndex);
+    // Build request body
+    const body = {
+        subject: {
+            birth_data: birthData,
+            ...(subjectName && { name: subjectName }),
+        },
+        return_year: returnYear,
+        options,
+    };
+    // Handle relocated return location
+    const useRelocatedReturn = executeFunctions.getNodeParameter("useRelocatedReturn", itemIndex, false);
+    if (useRelocatedReturn) {
+        const returnLocationType = executeFunctions.getNodeParameter("returnLocationType", itemIndex);
+        const returnLocation = {};
+        if (returnLocationType === "city") {
+            returnLocation.city = executeFunctions.getNodeParameter("returnCity", itemIndex);
+            returnLocation.country_code = executeFunctions.getNodeParameter("returnCountryCode", itemIndex);
+        }
+        else {
+            returnLocation.latitude = executeFunctions.getNodeParameter("returnLatitude", itemIndex);
+            returnLocation.longitude = executeFunctions.getNodeParameter("returnLongitude", itemIndex);
+        }
+        body.return_location = returnLocation;
+    }
+    const responseData = await (0, shared_1.makeApiRequest)(executeFunctions, "POST", baseUrl, CHARTS_ENDPOINTS.solarReturn, apiKey, body);
+    const simplify = executeFunctions.getNodeParameter("simplify", itemIndex, true);
+    return simplify ? (0, shared_1.simplifyResponse)(responseData) : responseData;
+}
+/**
+ * Handles lunar return chart generation (monthly forecast)
+ */
+async function handleLunarReturnChart(context) {
+    const { executeFunctions, itemIndex, baseUrl, apiKey } = context;
+    // Build natal subject
+    const birthData = (0, shared_1.buildBirthData)(executeFunctions, itemIndex);
+    const subjectName = executeFunctions.getNodeParameter("subjectName", itemIndex, "");
+    // Get return date (optional)
+    const lunarReturnDate = executeFunctions.getNodeParameter("lunarReturnDate", itemIndex, "");
+    // Get options
+    const options = getChartOptions(executeFunctions, itemIndex);
+    // Build request body
+    const body = {
+        subject: {
+            birth_data: birthData,
+            ...(subjectName && { name: subjectName }),
+        },
+        options,
+    };
+    if (lunarReturnDate) {
+        body.return_date = lunarReturnDate;
+    }
+    const responseData = await (0, shared_1.makeApiRequest)(executeFunctions, "POST", baseUrl, CHARTS_ENDPOINTS.lunarReturn, apiKey, body);
+    const simplify = executeFunctions.getNodeParameter("simplify", itemIndex, true);
+    return simplify ? (0, shared_1.simplifyResponse)(responseData) : responseData;
+}
+/**
+ * Handles progressions chart generation (secondary progressions)
+ */
+async function handleProgressionsChart(context) {
+    const { executeFunctions, itemIndex, baseUrl, apiKey } = context;
+    // Build natal subject
+    const birthData = (0, shared_1.buildBirthData)(executeFunctions, itemIndex);
+    const subjectName = executeFunctions.getNodeParameter("subjectName", itemIndex, "");
+    // Get target date
+    const targetDate = executeFunctions.getNodeParameter("targetDate", itemIndex);
+    // Get options
+    const options = getChartOptions(executeFunctions, itemIndex);
+    // Build request body
+    const body = {
+        subject: {
+            birth_data: birthData,
+            ...(subjectName && { name: subjectName }),
+        },
+        progression_date: targetDate,
+        options,
+    };
+    const responseData = await (0, shared_1.makeApiRequest)(executeFunctions, "POST", baseUrl, CHARTS_ENDPOINTS.progressions, apiKey, body);
+    const simplify = executeFunctions.getNodeParameter("simplify", itemIndex, true);
+    return simplify ? (0, shared_1.simplifyResponse)(responseData) : responseData;
+}
+/**
+ * Handles natal transits analysis (transit period over date range)
+ */
+async function handleNatalTransits(context) {
+    const { executeFunctions, itemIndex, baseUrl, apiKey } = context;
+    // Build natal subject
+    const birthData = (0, shared_1.buildBirthData)(executeFunctions, itemIndex);
+    const subjectName = executeFunctions.getNodeParameter("subjectName", itemIndex, "");
+    // Get date range
+    const startDate = executeFunctions.getNodeParameter("startDate", itemIndex);
+    const endDate = executeFunctions.getNodeParameter("endDate", itemIndex);
+    // Build request body
+    const body = {
+        subject: {
+            birth_data: birthData,
+            ...(subjectName && { name: subjectName }),
+        },
+        start_date: startDate,
+        end_date: endDate,
+    };
+    const responseData = await (0, shared_1.makeApiRequest)(executeFunctions, "POST", baseUrl, CHARTS_ENDPOINTS.natalTransits, apiKey, body);
+    const simplify = executeFunctions.getNodeParameter("simplify", itemIndex, true);
+    return simplify ? (0, shared_1.simplifyResponse)(responseData) : responseData;
+}
+/**
+ * Handles directions chart generation (primary directions)
+ */
+async function handleDirectionsChart(context) {
+    const { executeFunctions, itemIndex, baseUrl, apiKey } = context;
+    // Build natal subject
+    const birthData = (0, shared_1.buildBirthData)(executeFunctions, itemIndex);
+    const subjectName = executeFunctions.getNodeParameter("subjectName", itemIndex, "");
+    // Get target date
+    const targetDate = executeFunctions.getNodeParameter("targetDate", itemIndex);
+    // Get options
+    const options = getChartOptions(executeFunctions, itemIndex);
+    // Build request body
+    const body = {
+        subject: {
+            birth_data: birthData,
+            ...(subjectName && { name: subjectName }),
+        },
+        direction_date: targetDate,
+        options,
+    };
+    const responseData = await (0, shared_1.makeApiRequest)(executeFunctions, "POST", baseUrl, CHARTS_ENDPOINTS.directions, apiKey, body);
+    const simplify = executeFunctions.getNodeParameter("simplify", itemIndex, true);
+    return simplify ? (0, shared_1.simplifyResponse)(responseData) : responseData;
+}

package/dist/nodes/Astrology/interfaces/types.d.ts

@@ -37,7 +37,90 @@ export type HoroscopeOperation = "signDaily" | "signDailyText" | "signWeekly" |
 /**
  * Charts resource operations
  */
-export type ChartsOperation = "natal";
+export type ChartsOperation = "natal" | "synastry" | "transit" | "composite" | "solarReturn" | "lunarReturn" | "progressions" | "natalTransits" | "directions";
+/**
+ * Transit time structure for transit chart requests
+ */
+export interface ITransitTime {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute: number;
+    city?: string;
+    country_code?: string;
+    latitude?: number;
+    longitude?: number;
+}
+/**
+ * Two-subject request for synastry/composite charts
+ */
+export interface ITwoSubjectRequest {
+    subject1: {
+        name?: string;
+        birth_data: IBirthData;
+    };
+    subject2: {
+        name?: string;
+        birth_data: IBirthData;
+    };
+    options?: IDataObject;
+}
+/**
+ * Transit chart request structure
+ */
+export interface ITransitChartRequest {
+    subject: {
+        name?: string;
+        birth_data: IBirthData;
+    };
+    transit_time: {
+        datetime: ITransitTime;
+    };
+    options?: IDataObject;
+}
+/**
+ * Solar/Lunar return request structure
+ */
+export interface IReturnChartRequest {
+    subject: {
+        name?: string;
+        birth_data: IBirthData;
+    };
+    return_year?: number;
+    return_date?: string;
+    return_location?: {
+        city?: string;
+        country_code?: string;
+        latitude?: number;
+        longitude?: number;
+    };
+    options?: IDataObject;
+}
+/**
+ * Progressions/Directions request structure
+ */
+export interface IProgressionChartRequest {
+    subject: {
+        name?: string;
+        birth_data: IBirthData;
+    };
+    progression_date?: string;
+    direction_date?: string;
+    options?: IDataObject;
+}
+/**
+ * Natal transits (date range) request structure
+ */
+export interface INatalTransitsRequest {
+    subject: {
+        name?: string;
+        birth_data: IBirthData;
+    };
+    start_date: string;
+    end_date: string;
+    options?: IDataObject;
+}
 /**
  * Handler context passed to resource handlers
  */

package/dist/nodes/Astrology/operations/charts.operation.js

@@ -2,6 +2,33 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.chartsOperations = void 0;
 const shared_1 = require("../shared");
+/**
+ * Operation groups for displayOptions
+ */
+// Operations that use birth data (almost all except maybe specific ones)
+const birthDataOperations = [
+    "natal",
+    "synastry",
+    "transit",
+    "composite",
+    "solarReturn",
+    "lunarReturn",
+    "progressions",
+    "natalTransits",
+    "directions",
+];
+// Operations requiring two subjects
+const twoPersonOperations = ["synastry", "composite"];
+// Operations requiring transit time
+const transitOperations = ["transit"];
+// Solar return operations
+const solarReturnOperations = ["solarReturn"];
+// Lunar return operations
+const lunarReturnOperations = ["lunarReturn"];
+// Date-based operations (single target date)
+const dateBasedOperations = ["progressions", "directions"];
+// Date range operations
+const dateRangeOperations = ["natalTransits"];
 /**
  * All available active points for natal chart
  */
@@ -103,12 +130,60 @@ const chartsOperationField = {
         },
     },
     options: [
+        {
+            name: "Composite Chart",
+            value: "composite",
+            description: "Generate a merged midpoint chart representing the combined energy of two people as a relationship entity",
+            action: "Generate composite chart",
+        },
+        {
+            name: "Directions Chart",
+            value: "directions",
+            description: "Generate a primary directions chart for predictive timing of life events",
+            action: "Generate directions chart",
+        },
+        {
+            name: "Lunar Return Chart",
+            value: "lunarReturn",
+            description: "Generate a monthly forecast chart based on Moon returning to natal position",
+            action: "Generate lunar return chart",
+        },
         {
             name: "Natal Chart",
             value: "natal",
             description: "Generate a complete natal (birth) chart with planetary positions, house cusps, and aspects",
             action: "Generate natal chart",
         },
+        {
+            name: "Natal Transits",
+            value: "natalTransits",
+            description: "Analyze planetary transits over a date range against the natal chart for period forecasting",
+            action: "Get natal transits",
+        },
+        {
+            name: "Progressions Chart",
+            value: "progressions",
+            description: "Generate a secondary progressions chart showing internal development and life phase themes",
+            action: "Generate progressions chart",
+        },
+        {
+            name: "Solar Return Chart",
+            value: "solarReturn",
+            description: "Generate a birthday chart showing themes and predictions for the coming year based on Sun return",
+            action: "Generate solar return chart",
+        },
+        {
+            name: "Synastry Chart",
+            value: "synastry",
+            description: "Generate a relationship compatibility chart comparing two birth charts to analyze partnership dynamics",
+            action: "Generate synastry chart",
+        },
+        {
+            name: "Transit Chart",
+            value: "transit",
+            description: "Generate a transit overlay showing planetary positions at a specific time against the natal chart",
+            action: "Generate transit chart",
+        },
     ],
     default: "natal",
 };
@@ -435,6 +510,188 @@ const useCacheField = {
     default: true,
     description: "Whether to use cached calculations when available",
 };
+/**
+ * Solar Return year field
+ */
+const returnYearField = {
+    displayName: "Return Year",
+    name: "returnYear",
+    type: "number",
+    displayOptions: {
+        show: {
+            resource: ["charts"],
+            operation: solarReturnOperations,
+        },
+    },
+    default: 2024,
+    placeholder: "e.g. 2024",
+    description: "Year for the solar return chart (year of birthday to analyze)",
+    required: true,
+};
+/**
+ * Use relocated return toggle
+ */
+const useRelocatedReturnField = {
+    displayName: "Use Relocated Location",
+    name: "useRelocatedReturn",
+    type: "boolean",
+    displayOptions: {
+        show: {
+            resource: ["charts"],
+            operation: solarReturnOperations,
+        },
+    },
+    default: false,
+    description: "Whether to calculate for a different location than birth place (relocation astrology)",
+};
+/**
+ * Relocated return location type
+ */
+const returnLocationTypeField = {
+    displayName: "Return Location Type",
+    name: "returnLocationType",
+    type: "options",
+    displayOptions: {
+        show: {
+            resource: ["charts"],
+            operation: solarReturnOperations,
+            useRelocatedReturn: [true],
+        },
+    },
+    options: [
+        {
+            name: "City Name",
+            value: "city",
+            description: "Enter city and country",
+        },
+        {
+            name: "Coordinates",
+            value: "coordinates",
+            description: "Enter exact latitude and longitude",
+        },
+    ],
+    default: "city",
+    description: "How to specify the relocated return location",
+};
+/**
+ * Relocated return city
+ */
+const returnCityField = {
+    displayName: "Return City",
+    name: "returnCity",
+    type: "string",
+    displayOptions: {
+        show: {
+            resource: ["charts"],
+            operation: solarReturnOperations,
+            useRelocatedReturn: [true],
+            returnLocationType: ["city"],
+        },
+    },
+    default: "",
+    placeholder: "e.g. New York",
+    description: "City where you will be on your birthday",
+};
+/**
+ * Relocated return country code
+ */
+const returnCountryCodeField = {
+    displayName: "Return Country Code",
+    name: "returnCountryCode",
+    type: "string",
+    displayOptions: {
+        show: {
+            resource: ["charts"],
+            operation: solarReturnOperations,
+            useRelocatedReturn: [true],
+            returnLocationType: ["city"],
+        },
+    },
+    default: "",
+    placeholder: "e.g. US",
+    description: "2-letter ISO country code for return location",
+};
+/**
+ * Relocated return latitude
+ */
+const returnLatitudeField = {
+    displayName: "Return Latitude",
+    name: "returnLatitude",
+    type: "number",
+    displayOptions: {
+        show: {
+            resource: ["charts"],
+            operation: solarReturnOperations,
+            useRelocatedReturn: [true],
+            returnLocationType: ["coordinates"],
+        },
+    },
+    default: 0,
+    placeholder: "e.g. 40.71",
+    typeOptions: {
+        minValue: -90,
+        maxValue: 90,
+    },
+    description: "Latitude of return location (-90 to 90)",
+};
+/**
+ * Relocated return longitude
+ */
+const returnLongitudeField = {
+    displayName: "Return Longitude",
+    name: "returnLongitude",
+    type: "number",
+    displayOptions: {
+        show: {
+            resource: ["charts"],
+            operation: solarReturnOperations,
+            useRelocatedReturn: [true],
+            returnLocationType: ["coordinates"],
+        },
+    },
+    default: 0,
+    placeholder: "e.g. -74.01",
+    typeOptions: {
+        minValue: -180,
+        maxValue: 180,
+    },
+    description: "Longitude of return location (-180 to 180)",
+};
+/**
+ * Lunar Return date field
+ */
+const lunarReturnDateField = {
+    displayName: "Return Date",
+    name: "lunarReturnDate",
+    type: "string",
+    displayOptions: {
+        show: {
+            resource: ["charts"],
+            operation: lunarReturnOperations,
+        },
+    },
+    default: "",
+    placeholder: "2024-06-15",
+    description: "Target date for lunar return (YYYY-MM-DD). Leave empty for current/next lunar return.",
+};
+/**
+ * Progression/Direction date field
+ */
+const targetDateField = {
+    displayName: "Target Date",
+    name: "targetDate",
+    type: "string",
+    displayOptions: {
+        show: {
+            resource: ["charts"],
+            operation: dateBasedOperations,
+        },
+    },
+    default: "",
+    placeholder: "2024-06-15",
+    description: "Target date for progression/direction calculation (YYYY-MM-DD format)",
+    required: true,
+};
 /**
  * Simplify output toggle for charts resource
  */
@@ -455,10 +712,30 @@ const simplifyField = {
  */
 exports.chartsOperations = [
     chartsOperationField,
+    // Subject 1 fields (for all operations)
     subjectNameField,
-    ...(0, shared_1.createBirthDataFields)("charts"),
+    ...(0, shared_1.createBirthDataFields)("charts", birthDataOperations),
     secondField,
-    ...(0, shared_1.createLocationFields)("charts"),
+    ...(0, shared_1.createLocationFields)("charts", birthDataOperations),
+    // Subject 2 fields (for synastry, composite)
+    ...(0, shared_1.createSecondSubjectFields)("charts", twoPersonOperations),
+    // Transit time fields (for transit operation)
+    ...(0, shared_1.createTransitTimeFields)("charts", transitOperations),
+    // Solar Return fields
+    returnYearField,
+    useRelocatedReturnField,
+    returnLocationTypeField,
+    returnCityField,
+    returnCountryCodeField,
+    returnLatitudeField,
+    returnLongitudeField,
+    // Lunar Return fields
+    lunarReturnDateField,
+    // Progression/Direction date field
+    targetDateField,
+    // Date range fields (for natalTransits)
+    ...(0, shared_1.createDateRangeFields)("charts", dateRangeOperations),
+    // Chart options (for most operations)
     houseSystemField,
     zodiacTypeField,
     activePointsPresetField,
@@ -466,6 +743,7 @@ exports.chartsOperations = [
     perspectiveField,
     precisionField,
     simplifyField,
+    // Advanced options
     showAdvancedOptionsField,
     enableFixedStarsField,
     fixedStarPresetsField,

package/dist/nodes/Astrology/shared/dateRange.fields.d.ts

@@ -0,0 +1,8 @@
+import type { INodeProperties } from "n8n-workflow";
+/**
+ * Creates date range fields for natal transits analysis
+ *
+ * @param resourceName - The resource value to show these fields for
+ * @param showForOperations - Operations that should show these fields
+ */
+export declare function createDateRangeFields(resourceName: string, showForOperations: string[]): INodeProperties[];

package/dist/nodes/Astrology/shared/dateRange.fields.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDateRangeFields = createDateRangeFields;
+/**
+ * Creates date range fields for natal transits analysis
+ *
+ * @param resourceName - The resource value to show these fields for
+ * @param showForOperations - Operations that should show these fields
+ */
+function createDateRangeFields(resourceName, showForOperations) {
+    const baseDisplayOptions = {
+        show: {
+            resource: [resourceName],
+            operation: showForOperations,
+        },
+    };
+    return [
+        // Section header
+        {
+            displayName: "Date Range for Transit Analysis",
+            name: "dateRangeNotice",
+            type: "notice",
+            displayOptions: { ...baseDisplayOptions },
+            default: "",
+        },
+        {
+            displayName: "Start Date",
+            name: "startDate",
+            type: "string",
+            displayOptions: { ...baseDisplayOptions },
+            default: "",
+            placeholder: "2024-01-01",
+            description: "Start date for transit analysis period (YYYY-MM-DD format)",
+            required: true,
+        },
+        {
+            displayName: "End Date",
+            name: "endDate",
+            type: "string",
+            displayOptions: { ...baseDisplayOptions },
+            default: "",
+            placeholder: "2024-12-31",
+            description: "End date for transit analysis period (YYYY-MM-DD format)",
+            required: true,
+        },
+    ];
+}

package/dist/nodes/Astrology/shared/index.d.ts

@@ -1,4 +1,7 @@
 export { createBirthDataFields } from "./birthData.fields";
 export { createLocationFields } from "./location.fields";
 export { zodiacSignOptions, createZodiacSignField, traditionOptions, createTraditionField, } from "./zodiac.fields";
+export { createSecondSubjectFields } from "./secondSubject.fields";
+export { createTransitTimeFields } from "./transitTime.fields";
+export { createDateRangeFields } from "./dateRange.fields";
 export { buildBirthData, makeApiRequest, createSubjectRequest, simplifyResponse, } from "./helpers";

package/dist/nodes/Astrology/shared/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.simplifyResponse = exports.createSubjectRequest = exports.makeApiRequest = exports.buildBirthData = exports.createTraditionField = exports.traditionOptions = exports.createZodiacSignField = exports.zodiacSignOptions = exports.createLocationFields = exports.createBirthDataFields = void 0;
+exports.simplifyResponse = exports.createSubjectRequest = exports.makeApiRequest = exports.buildBirthData = exports.createDateRangeFields = exports.createTransitTimeFields = exports.createSecondSubjectFields = exports.createTraditionField = exports.traditionOptions = exports.createZodiacSignField = exports.zodiacSignOptions = exports.createLocationFields = exports.createBirthDataFields = void 0;
 // Shared field creators
 var birthData_fields_1 = require("./birthData.fields");
 Object.defineProperty(exports, "createBirthDataFields", { enumerable: true, get: function () { return birthData_fields_1.createBirthDataFields; } });
@@ -11,6 +11,12 @@ Object.defineProperty(exports, "zodiacSignOptions", { enumerable: true, get: fun
 Object.defineProperty(exports, "createZodiacSignField", { enumerable: true, get: function () { return zodiac_fields_1.createZodiacSignField; } });
 Object.defineProperty(exports, "traditionOptions", { enumerable: true, get: function () { return zodiac_fields_1.traditionOptions; } });
 Object.defineProperty(exports, "createTraditionField", { enumerable: true, get: function () { return zodiac_fields_1.createTraditionField; } });
+var secondSubject_fields_1 = require("./secondSubject.fields");
+Object.defineProperty(exports, "createSecondSubjectFields", { enumerable: true, get: function () { return secondSubject_fields_1.createSecondSubjectFields; } });
+var transitTime_fields_1 = require("./transitTime.fields");
+Object.defineProperty(exports, "createTransitTimeFields", { enumerable: true, get: function () { return transitTime_fields_1.createTransitTimeFields; } });
+var dateRange_fields_1 = require("./dateRange.fields");
+Object.defineProperty(exports, "createDateRangeFields", { enumerable: true, get: function () { return dateRange_fields_1.createDateRangeFields; } });
 // Helper functions
 var helpers_1 = require("./helpers");
 Object.defineProperty(exports, "buildBirthData", { enumerable: true, get: function () { return helpers_1.buildBirthData; } });

package/dist/nodes/Astrology/shared/secondSubject.fields.d.ts

@@ -0,0 +1,9 @@
+import type { INodeProperties } from "n8n-workflow";
+/**
+ * Creates second subject fields (subject2*) for synastry/composite charts
+ * Includes birth data and location with subject2 prefix
+ *
+ * @param resourceName - The resource value to show these fields for
+ * @param showForOperations - Operations that should show these fields
+ */
+export declare function createSecondSubjectFields(resourceName: string, showForOperations: string[]): INodeProperties[];

package/dist/nodes/Astrology/shared/secondSubject.fields.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSecondSubjectFields = createSecondSubjectFields;
+/**
+ * Creates second subject fields (subject2*) for synastry/composite charts
+ * Includes birth data and location with subject2 prefix
+ *
+ * @param resourceName - The resource value to show these fields for
+ * @param showForOperations - Operations that should show these fields
+ */
+function createSecondSubjectFields(resourceName, showForOperations) {
+    const baseDisplayOptions = {
+        show: {
+            resource: [resourceName],
+            operation: showForOperations,
+        },
+    };
+    // City-based location displayOptions for subject2
+    const cityDisplayOptions = {
+        show: {
+            ...baseDisplayOptions.show,
+            subject2LocationType: ["city"],
+        },
+    };
+    // Coordinate-based location displayOptions for subject2
+    const coordDisplayOptions = {
+        show: {
+            ...baseDisplayOptions.show,
+            subject2LocationType: ["coordinates"],
+        },
+    };
+    return [
+        // Section header
+        {
+            displayName: "Second Person Birth Data",
+            name: "subject2Notice",
+            type: "notice",
+            displayOptions: { ...baseDisplayOptions },
+            default: "",
+        },
+        // Optional name
+        {
+            displayName: "Name (Subject 2)",
+            name: "subject2Name",
+            type: "string",
+            displayOptions: { ...baseDisplayOptions },
+            default: "",
+            placeholder: "e.g. Partner",
+            description: "Optional name for the second person (used in report titles)",
+        },
+        // Birth data fields
+        {
+            displayName: "Year (Subject 2)",
+            name: "subject2Year",
+            type: "number",
+            displayOptions: { ...baseDisplayOptions },
+            default: 1990,
+            placeholder: "e.g. 1990",
+            description: "Birth year of the second person (e.g., 1990)",
+            required: true,
+        },
+        {
+            displayName: "Month (Subject 2)",
+            name: "subject2Month",
+            type: "number",
+            displayOptions: { ...baseDisplayOptions },
+            default: 1,
+            placeholder: "e.g. 6",
+            typeOptions: {
+                minValue: 1,
+                maxValue: 12,
+            },
+            description: "Birth month of the second person (1-12)",
+            required: true,
+        },
+        {
+            displayName: "Day (Subject 2)",
+            name: "subject2Day",
+            type: "number",
+            displayOptions: { ...baseDisplayOptions },
+            default: 1,
+            placeholder: "e.g. 15",
+            typeOptions: {
+                minValue: 1,
+                maxValue: 31,
+            },
+            description: "Birth day of the second person (1-31)",
+            required: true,
+        },
+        {
+            displayName: "Hour (Subject 2)",
+            name: "subject2Hour",
+            type: "number",
+            displayOptions: { ...baseDisplayOptions },
+            default: 12,
+            placeholder: "e.g. 14",
+            typeOptions: {
+                minValue: 0,
+                maxValue: 23,
+            },
+            description: "Birth hour of the second person in 24-hour format (0-23)",
+            required: true,
+        },
+        {
+            displayName: "Minute (Subject 2)",
+            name: "subject2Minute",
+            type: "number",
+            displayOptions: { ...baseDisplayOptions },
+            default: 0,
+            placeholder: "e.g. 30",
+            typeOptions: {
+                minValue: 0,
+                maxValue: 59,
+            },
+            description: "Birth minute of the second person (0-59)",
+            required: true,
+        },
+        // Location type selector
+        {
+            displayName: "Location Type (Subject 2)",
+            name: "subject2LocationType",
+            type: "options",
+            displayOptions: { ...baseDisplayOptions },
+            options: [
+                {
+                    name: "City Name",
+                    value: "city",
+                    description: "Enter city and country - coordinates detected automatically",
+                },
+                {
+                    name: "Coordinates",
+                    value: "coordinates",
+                    description: "Enter exact latitude and longitude",
+                },
+            ],
+            default: "city",
+            description: "How to specify the second person's birth location",
+        },
+        // City-based location fields
+        {
+            displayName: "City (Subject 2)",
+            name: "subject2City",
+            type: "string",
+            displayOptions: cityDisplayOptions,
+            default: "",
+            placeholder: "London",
+            description: "Birth city of the second person",
+            required: true,
+        },
+        {
+            displayName: "Country Code (Subject 2)",
+            name: "subject2CountryCode",
+            type: "string",
+            displayOptions: cityDisplayOptions,
+            default: "",
+            placeholder: "GB",
+            description: "2-letter ISO country code for the second person's birth city",
+            required: true,
+        },
+        // Coordinate-based location fields
+        {
+            displayName: "Latitude (Subject 2)",
+            name: "subject2Latitude",
+            type: "number",
+            displayOptions: coordDisplayOptions,
+            default: 0,
+            placeholder: "e.g. 50.45",
+            typeOptions: {
+                minValue: -90,
+                maxValue: 90,
+            },
+            description: "Latitude of the second person's birth location (-90 to 90)",
+            required: true,
+        },
+        {
+            displayName: "Longitude (Subject 2)",
+            name: "subject2Longitude",
+            type: "number",
+            displayOptions: coordDisplayOptions,
+            default: 0,
+            placeholder: "e.g. 30.52",
+            typeOptions: {
+                minValue: -180,
+                maxValue: 180,
+            },
+            description: "Longitude of the second person's birth location (-180 to 180)",
+            required: true,
+        },
+    ];
+}

package/dist/nodes/Astrology/shared/transitTime.fields.d.ts

@@ -0,0 +1,9 @@
+import type { INodeProperties } from "n8n-workflow";
+/**
+ * Creates transit time fields for transit chart overlay
+ * Includes datetime and optional location fields with transit prefix
+ *
+ * @param resourceName - The resource value to show these fields for
+ * @param showForOperations - Operations that should show these fields
+ */
+export declare function createTransitTimeFields(resourceName: string, showForOperations: string[]): INodeProperties[];

package/dist/nodes/Astrology/shared/transitTime.fields.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTransitTimeFields = createTransitTimeFields;
+/**
+ * Creates transit time fields for transit chart overlay
+ * Includes datetime and optional location fields with transit prefix
+ *
+ * @param resourceName - The resource value to show these fields for
+ * @param showForOperations - Operations that should show these fields
+ */
+function createTransitTimeFields(resourceName, showForOperations) {
+    const baseDisplayOptions = {
+        show: {
+            resource: [resourceName],
+            operation: showForOperations,
+        },
+    };
+    // City-based location displayOptions for transit
+    const cityDisplayOptions = {
+        show: {
+            ...baseDisplayOptions.show,
+            transitLocationType: ["city"],
+        },
+    };
+    // Coordinate-based location displayOptions for transit
+    const coordDisplayOptions = {
+        show: {
+            ...baseDisplayOptions.show,
+            transitLocationType: ["coordinates"],
+        },
+    };
+    return [
+        // Section header
+        {
+            displayName: "Transit Time",
+            name: "transitNotice",
+            type: "notice",
+            displayOptions: { ...baseDisplayOptions },
+            default: "",
+        },
+        // Transit datetime fields
+        {
+            displayName: "Transit Year",
+            name: "transitYear",
+            type: "number",
+            displayOptions: { ...baseDisplayOptions },
+            default: 2024,
+            placeholder: "e.g. 2024",
+            description: "Year for the transit calculation",
+            required: true,
+        },
+        {
+            displayName: "Transit Month",
+            name: "transitMonth",
+            type: "number",
+            displayOptions: { ...baseDisplayOptions },
+            default: 1,
+            placeholder: "e.g. 6",
+            typeOptions: {
+                minValue: 1,
+                maxValue: 12,
+            },
+            description: "Month for the transit calculation (1-12)",
+            required: true,
+        },
+        {
+            displayName: "Transit Day",
+            name: "transitDay",
+            type: "number",
+            displayOptions: { ...baseDisplayOptions },
+            default: 1,
+            placeholder: "e.g. 15",
+            typeOptions: {
+                minValue: 1,
+                maxValue: 31,
+            },
+            description: "Day for the transit calculation (1-31)",
+            required: true,
+        },
+        {
+            displayName: "Transit Hour",
+            name: "transitHour",
+            type: "number",
+            displayOptions: { ...baseDisplayOptions },
+            default: 12,
+            placeholder: "e.g. 14",
+            typeOptions: {
+                minValue: 0,
+                maxValue: 23,
+            },
+            description: "Hour for the transit calculation in 24-hour format (0-23)",
+            required: true,
+        },
+        {
+            displayName: "Transit Minute",
+            name: "transitMinute",
+            type: "number",
+            displayOptions: { ...baseDisplayOptions },
+            default: 0,
+            placeholder: "e.g. 30",
+            typeOptions: {
+                minValue: 0,
+                maxValue: 59,
+            },
+            description: "Minute for the transit calculation (0-59)",
+            required: true,
+        },
+        // Location type selector for transit
+        {
+            displayName: "Transit Location Type",
+            name: "transitLocationType",
+            type: "options",
+            displayOptions: { ...baseDisplayOptions },
+            options: [
+                {
+                    name: "City Name",
+                    value: "city",
+                    description: "Enter city and country - coordinates detected automatically",
+                },
+                {
+                    name: "Coordinates",
+                    value: "coordinates",
+                    description: "Enter exact latitude and longitude",
+                },
+            ],
+            default: "city",
+            description: "How to specify the location for transit calculation",
+        },
+        // City-based location fields
+        {
+            displayName: "Transit City",
+            name: "transitCity",
+            type: "string",
+            displayOptions: cityDisplayOptions,
+            default: "",
+            placeholder: "London",
+            description: "City for the transit calculation",
+            required: true,
+        },
+        {
+            displayName: "Transit Country Code",
+            name: "transitCountryCode",
+            type: "string",
+            displayOptions: cityDisplayOptions,
+            default: "",
+            placeholder: "GB",
+            description: "2-letter ISO country code for the transit location",
+            required: true,
+        },
+        // Coordinate-based location fields
+        {
+            displayName: "Transit Latitude",
+            name: "transitLatitude",
+            type: "number",
+            displayOptions: coordDisplayOptions,
+            default: 0,
+            placeholder: "e.g. 50.45",
+            typeOptions: {
+                minValue: -90,
+                maxValue: 90,
+            },
+            description: "Latitude for the transit location (-90 to 90)",
+            required: true,
+        },
+        {
+            displayName: "Transit Longitude",
+            name: "transitLongitude",
+            type: "number",
+            displayOptions: coordDisplayOptions,
+            default: 0,
+            placeholder: "e.g. 30.52",
+            typeOptions: {
+                minValue: -180,
+                maxValue: 180,
+            },
+            description: "Longitude for the transit location (-180 to 180)",
+            required: true,
+        },
+    ];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astro-api/n8n-nodes-astrology",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "n8n community node for Astrology API - professional astrological calculations, charts, horoscopes, and interpretations",
   "main": "dist/index.js",
   "scripts": {