requests.py

"""Request models for the Astrology API client."""

from __future__ import annotations

from typing import Any

from pydantic import BaseModel, ConfigDict

from astroapi.types.config import (
    AnalysisDirectionType,
    DetailLevel,
    DirectionType,
    GematriaMethod,
    Gender,
    HoraryCategory,
    HouseSystem,
    KabbalahSystem,
    Language,
    NumerologySystem,
    PdfFontStyle,
    PdfOrientation,
    PdfPageSize,
    PdfSign,
    PdfTheme,
    PreferredPass,
    ProgressionType,
    RenderFormat,
    RenderTheme,
    ReturnDirection,
    Sign,
    TarotInterpretationDepth,
    TarotReportSpread,
    TarotSpread,
    TarotTradition,
    TextFormat,
    TikkunMethod,
    VedicAyanamsa,
    VedicBhavaSystem,
    VedicChartStyle,
    VedicChartTheme,
    VedicDashaLevel,
    VedicDivisionalChart,
    VedicFestivalType,
    VedicNodeType,
    VedicRemedyType,
    VedicSignFormat,
    VedicYogaCategory,
    ZodiacType,
)


class BirthData(BaseModel):
    """Birth data for a subject (flexible version for insights/numerology endpoints).

    Attributes:
        year: Birth year (required, 1900-2100)
        month: Birth month (1-12, optional)
        day: Birth day (1-31, optional)
        hour: Birth hour (0-23, optional)
        minute: Birth minute (0-59, optional)
        second: Birth second (0-59, optional)
        city: Birth city name (optional)
        country_code: ISO country code (optional)
        latitude: Birth latitude (-90 to 90, optional)
        longitude: Birth longitude (-180 to 180, optional)
        timezone: Timezone identifier (e.g., 'America/New_York', optional)
    """

    model_config = ConfigDict(extra="forbid")

    year: int
    month: int | None = None
    day: int | None = None
    hour: int | None = None
    minute: int | None = None
    second: int | None = None
    city: str | None = None
    country_code: str | None = None
    latitude: float | None = None
    longitude: float | None = None
    timezone: str | None = None


class DateTimeLocation(BaseModel):
    """Date, time and location data (strict version for charts/transits).

    Attributes:
        year: Year (required, 1900-2100)
        month: Month (1-12, required)
        day: Day (1-31, required)
        hour: Hour (0-23, required)
        minute: Minute (0-59, required)
        second: Second (0-59, optional)
        latitude: Latitude (-90 to 90, optional)
        longitude: Longitude (-180 to 180, optional)
        city: City name (optional)
        country_code: ISO country code (optional)
        timezone: Timezone identifier (optional)
    """

    model_config = ConfigDict(extra="forbid")

    year: int
    month: int
    day: int
    hour: int
    minute: int
    second: int | None = None
    latitude: float | None = None
    longitude: float | None = None
    city: str | None = None
    country_code: str | None = None
    timezone: str | None = None


class Subject(BaseModel):
    """Subject information with birth data.

    Attributes:
        birth_data: Birth data for the subject
        name: Subject name (optional)
        email: Subject email (optional)
        notes: Additional notes (optional)
    """

    model_config = ConfigDict(extra="forbid")

    birth_data: BirthData
    name: str | None = None
    email: str | None = None
    notes: str | None = None


class SimpleDate(BaseModel):
    """Simple date without time information.

    Attributes:
        year: Year (1900-2100)
        month: Month (1-12)
        day: Day (1-31)
    """

    model_config = ConfigDict(extra="forbid")

    year: int
    month: int
    day: int


class DateRange(BaseModel):
    """Date range with start and end dates.

    Attributes:
        start_date: Start date
        end_date: End date
    """

    model_config = ConfigDict(extra="forbid")

    start_date: SimpleDate
    end_date: SimpleDate


class FixedStarsConfig(BaseModel):
    """Configuration for fixed stars calculations.

    Attributes:
        include: Whether to include fixed stars
        max_orb: Maximum orb for fixed star aspects (0.0-10.0)
        stars: List of specific stars to include (optional)
    """

    model_config = ConfigDict(extra="forbid")

    include: bool = True
    max_orb: float | None = None
    stars: list[str] | None = None


class ChartOptions(BaseModel):
    """Options for chart calculations.

    Attributes:
        house_system: House system to use
        zodiac_type: Zodiac type (Tropic or Sidereal)
        active_points: List of active points/planets to include
        precision: Calculation precision
        return_year: Year for solar return calculations
        return_date: Date for lunar return calculations (YYYY-MM-DD)
        target_date: Target date for progressions/directions (YYYY-MM-DD)
        perspective: Perspective type (geocentric, heliocentric, draconic, barycentric)
        fixed_stars: Fixed stars configuration
    """

    model_config = ConfigDict(extra="forbid")

    house_system: HouseSystem | None = None
    zodiac_type: ZodiacType | None = None
    active_points: list[str] | None = None
    precision: int | None = None
    return_year: int | None = None
    return_date: str | None = None
    target_date: str | None = None
    perspective: str | None = None
    fixed_stars: FixedStarsConfig | None = None


class DataOptions(BaseModel):
    """Options for data queries.

    Attributes:
        house_system: House system to use
        zodiac_type: Zodiac type
        precision: Calculation precision
        include_houses: Whether to include house cusps
        include_aspects: Whether to include aspects
    """

    model_config = ConfigDict(extra="forbid")

    house_system: HouseSystem | None = None
    zodiac_type: ZodiacType | None = None
    precision: int | None = None
    include_houses: bool | None = None
    include_aspects: bool | None = None


class ReportOptions(BaseModel):
    """Options for report generation.

    Attributes:
        tradition: Report tradition (universal, psychological, event_oriented, classical)
        language: Language for the report
        detail_level: Level of detail
        minimum_strength: Minimum aspect strength to include
    """

    model_config = ConfigDict(extra="forbid")

    tradition: str | None = None
    language: Language | None = None
    detail_level: DetailLevel | None = None
    minimum_strength: float | None = None


# Data Endpoints


class PlanetaryPositionsRequest(BaseModel):
    """Request for planetary positions.

    Attributes:
        year: Year
        month: Month
        day: Day
        hour: Hour
        minute: Minute
        second: Second (optional)
        latitude: Latitude (optional)
        longitude: Longitude (optional)
        options: Data options (optional)
    """

    model_config = ConfigDict(extra="forbid")

    year: int
    month: int
    day: int
    hour: int
    minute: int
    second: int | None = None
    latitude: float | None = None
    longitude: float | None = None
    options: DataOptions | None = None


class DataRequest(BaseModel):
    """Generic data request with subject.

    Attributes:
        subject: Subject information
        options: Data options (optional)
    """

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    options: DataOptions | None = None


# Chart Endpoints


class NatalChartRequest(BaseModel):
    """Request for natal chart.

    Attributes:
        subject: Subject information
        options: Chart options (optional)
    """

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    options: ChartOptions | None = None


class SynastryChartRequest(BaseModel):
    """Request for synastry chart.

    Attributes:
        subject1: First subject
        subject2: Second subject
        options: Chart options (optional)
    """

    model_config = ConfigDict(extra="forbid")

    subject1: Subject
    subject2: Subject
    options: ChartOptions | None = None


class CompositeChartRequest(BaseModel):
    """Request for composite chart.

    Attributes:
        subject1: First subject
        subject2: Second subject
        options: Chart options (optional)
    """

    model_config = ConfigDict(extra="forbid")

    subject1: Subject
    subject2: Subject
    options: ChartOptions | None = None


class TransitChartRequest(BaseModel):
    """Request for transit chart.

    Attributes:
        natal_subject: Natal subject
        transit_datetime: Transit date/time/location
        options: Chart options (optional)
        orbs: Custom orbs configuration (optional)
    """

    model_config = ConfigDict(extra="forbid")

    natal_subject: Subject
    transit_datetime: DateTimeLocation
    options: ChartOptions | None = None
    orbs: dict[str, Any] | None = None


class SolarReturnRequest(BaseModel):
    """Request for solar return chart.

    Attributes:
        subject: Subject information
        return_year: Year of the solar return
        return_location: Location for the return (optional, defaults to birth location)
        options: Chart options (optional)
    """

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    return_year: int
    return_location: DateTimeLocation | None = None
    options: ChartOptions | None = None


class LunarReturnRequest(BaseModel):
    """Request for lunar return chart.

    Attributes:
        subject: Subject information
        return_date: Date of the lunar return (YYYY-MM-DD)
        return_location: Location for the return (optional)
        options: Chart options (optional)
    """

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    return_date: str
    return_location: DateTimeLocation | None = None
    options: ChartOptions | None = None


class ProgressionRequest(BaseModel):
    """Request for progression chart.

    Attributes:
        subject: Subject information
        target_date: Target date for progression (YYYY-MM-DD)
        progression_type: Type of progression
        location: Location for progression (optional)
        options: Chart options (optional)
    """

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    target_date: str
    progression_type: ProgressionType
    location: DateTimeLocation | None = None
    options: ChartOptions | None = None


class DirectionRequest(BaseModel):
    """Request for direction chart.

    Attributes:
        subject: Subject information
        target_date: Target date for direction (YYYY-MM-DD)
        direction_type: Type of direction
        arc_rate: Arc rate for calculations (optional)
        options: Chart options (optional)
    """

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    target_date: str
    direction_type: DirectionType
    arc_rate: float | None = None
    options: ChartOptions | None = None


# Horoscope Endpoints


class PersonalizedHoroscopeRequest(BaseModel):
    """Request for personalized horoscope.

    Attributes:
        subject: Subject information
        date: Date for horoscope (YYYY-MM-DD, optional)
        horoscope_type: Type of horoscope (daily, weekly, monthly, yearly)
        language: Language for the horoscope
        tradition: Report tradition (optional)
        include_transits: Whether to include transits
        house_system: House system to use
        include_progressions: Whether to include progressions
        minimum_strength: Minimum aspect strength
    """

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    date: str | None = None
    horoscope_type: str | None = "daily"
    language: Language | None = "en"
    tradition: str | None = None
    include_transits: bool | None = None
    house_system: HouseSystem | None = None
    include_progressions: bool | None = None
    minimum_strength: float | None = None


class SunSignHoroscopeRequest(BaseModel):
    """Request for sun sign horoscope.

    Attributes:
        sign: Sun sign
        date: Date for horoscope (YYYY-MM-DD)
        language: Language for the horoscope
        tradition: Report tradition (optional)
        minimum_strength: Minimum aspect strength
    """

    model_config = ConfigDict(extra="forbid")

    sign: Sign
    date: str
    language: Language | None = "en"
    tradition: str | None = None
    minimum_strength: float | None = None


# Analysis Endpoints


class AnalysisRequest(BaseModel):
    """Generic analysis request.

    Attributes:
        subject: Subject information
        options: Report options (optional)
    """

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    options: ReportOptions | None = None


class SynastryAnalysisRequest(BaseModel):
    """Request for synastry analysis.

    Attributes:
        subject1: First subject
        subject2: Second subject
        options: Report options (optional)
    """

    model_config = ConfigDict(extra="forbid")

    subject1: Subject
    subject2: Subject
    options: ReportOptions | None = None


class CompositeAnalysisRequest(BaseModel):
    """Request for composite analysis.

    Attributes:
        subject1: First subject
        subject2: Second subject
        options: Report options (optional)
    """

    model_config = ConfigDict(extra="forbid")

    subject1: Subject
    subject2: Subject
    options: ReportOptions | None = None


class TransitAnalysisRequest(BaseModel):
    """Request for transit analysis.

    Attributes:
        natal_subject: Natal subject
        transit_datetime: Transit date/time/location
        options: Report options (optional)
    """

    model_config = ConfigDict(extra="forbid")

    natal_subject: Subject
    transit_datetime: DateTimeLocation
    options: ReportOptions | None = None


# Chinese Astrology


class BaZiRequest(BaseModel):
    """Request for BaZi (Four Pillars) analysis.

    Attributes:
        subject: Subject information
        language: Language for the report
    """

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    language: Language | None = "en"


# Numerology


class NumerologyRequest(BaseModel):
    """Request for numerology analysis.

    Attributes:
        subject: Subject information
        system: Numerology system (pythagorean or chaldean)
        language: Language for the report
    """

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    system: NumerologySystem | None = "pythagorean"
    language: Language | None = "en"


# Tarot


class DrawCardsRequest(BaseModel):
    """Request to draw tarot cards.

    Attributes:
        count: Number of cards to draw (1-78)
        spread: Spread type (optional)
        question: Question for the reading (optional)
    """

    model_config = ConfigDict(extra="forbid")

    count: int = 1
    spread: TarotSpread | None = None
    question: str | None = None


class TarotReadingRequest(BaseModel):
    """Request for tarot reading.

    Attributes:
        cards: List of card identifiers
        positions: List of position meanings
        question: Question for the reading
        language: Language for the reading
    """

    model_config = ConfigDict(extra="forbid")

    cards: list[str]
    positions: list[str] | None = None
    question: str | None = None
    language: Language | None = "en"


# Eclipses


class EclipsesRequest(BaseModel):
    """Request for eclipses in a date range.

    Attributes:
        date_range: Date range to search
        eclipse_type: Type of eclipse (solar, lunar, or all)
    """

    model_config = ConfigDict(extra="forbid")

    date_range: DateRange
    eclipse_type: str | None = "all"


# Lunar


class MoonPhaseRequest(BaseModel):
    """Request for moon phase information.

    Attributes:
        date: Date for moon phase (YYYY-MM-DD)
        latitude: Latitude (optional)
        longitude: Longitude (optional)
    """

    model_config = ConfigDict(extra="forbid")

    date: str
    latitude: float | None = None
    longitude: float | None = None


# Astrocartography


class AstrocartographyRequest(BaseModel):
    """Request for astrocartography data.

    Attributes:
        subject: Subject information
        lines: List of planetary lines to calculate
        options: Chart options (optional)
    """

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    lines: list[str] | None = None
    options: ChartOptions | None = None


# Traditional


class DignityRequest(BaseModel):
    """Request for planetary dignities.

    Attributes:
        subject: Subject information
        tradition: Traditional system (optional)
    """

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    tradition: str | None = None


# Glossary (no complex request types, mostly simple query params)

# SVG (uses same request types as chart endpoints)

# Insights


class RelationshipInsightRequest(BaseModel):
    """Request for relationship insights.

    Attributes:
        subject1: First subject
        subject2: Second subject
        insight_type: Type of insight (compatibility, dynamics, etc.)
        language: Language for the insights
    """

    model_config = ConfigDict(extra="forbid")

    subject1: Subject
    subject2: Subject
    insight_type: str | None = None
    language: Language | None = "en"


class PetInsightRequest(BaseModel):
    """Request for pet compatibility insights.

    Attributes:
        owner: Owner subject
        pet: Pet subject
        language: Language for the insights
    """

    model_config = ConfigDict(extra="forbid")

    owner: Subject
    pet: Subject
    language: Language | None = "en"


class WellnessInsightRequest(BaseModel):
    """Request for wellness insights.

    Attributes:
        subject: Subject information
        focus_area: Focus area (health, fitness, mental, etc.)
        language: Language for the insights
    """

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    focus_area: str | None = None
    language: Language | None = "en"


class FinancialInsightRequest(BaseModel):
    """Request for financial insights.

    Attributes:
        subject: Subject information
        insight_type: Type of insight (investment, career, etc.)
        language: Language for the insights
    """

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    insight_type: str | None = None
    language: Language | None = "en"


class BusinessInsightRequest(BaseModel):
    """Request for business timing insights.

    Attributes:
        subject: Subject information
        event_date: Date for event planning (YYYY-MM-DD, optional)
        business_type: Type of business activity
        language: Language for the insights
    """

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    event_date: str | None = None
    business_type: str | None = None
    language: Language | None = "en"


# Venus Return (Charts + Analysis)


class VenusReturnRequest(BaseModel):
    """Request for Venus return chart."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    return_date: str
    direction: ReturnDirection | None = None
    preferred_pass: PreferredPass | None = None
    return_location: DateTimeLocation | None = None
    options: ChartOptions | None = None


# Natal Transits


class NatalTransitsRequest(BaseModel):
    """Request for natal transit period analysis."""

    model_config = ConfigDict(extra="forbid")

    natal_subject: Subject
    date_range: DateRange
    options: ChartOptions | None = None


# Analysis - Additional endpoints


class SolarReturnReportRequest(BaseModel):
    """Request for solar return report."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    return_year: int
    return_location: DateTimeLocation | None = None
    options: ChartOptions | None = None
    report_options: ReportOptions | None = None


class LunarReturnReportRequest(BaseModel):
    """Request for lunar return report."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    return_date: str
    return_location: DateTimeLocation | None = None
    options: ChartOptions | None = None
    report_options: ReportOptions | None = None


class VenusReturnReportRequest(BaseModel):
    """Request for Venus return report."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    return_date: str
    direction: ReturnDirection | None = None
    preferred_pass: PreferredPass | None = None
    return_location: DateTimeLocation | None = None
    options: ChartOptions | None = None
    report_options: ReportOptions | None = None


class ReturnTransitReportRequest(BaseModel):
    """Request for return transit report (solar/lunar/venus)."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    return_year: int | None = None
    return_date: str | None = None
    direction: ReturnDirection | None = None
    preferred_pass: PreferredPass | None = None
    return_location: DateTimeLocation | None = None
    date_range: DateRange | None = None
    orb: float | None = None
    options: ChartOptions | None = None
    report_options: ReportOptions | None = None


class NatalTransitReportRequest(BaseModel):
    """Request for natal transit report / predictive analysis."""

    model_config = ConfigDict(extra="forbid")

    natal_subject: Subject
    date_range: DateRange | None = None
    transit_datetime: DateTimeLocation | None = None
    orb: float | None = None
    report_options: ReportOptions | None = None


class DirectionReportRequest(BaseModel):
    """Request for direction report."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    target_date: str
    direction_type: AnalysisDirectionType | None = None
    arc_rate: float | None = None
    options: ChartOptions | None = None
    report_options: ReportOptions | None = None


class ProgressionReportRequest(BaseModel):
    """Request for progression report."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    target_date: str
    progression_type: ProgressionType | None = None
    location: DateTimeLocation | None = None
    options: ChartOptions | None = None
    report_options: ReportOptions | None = None


class RelocationAnalysisRequest(BaseModel):
    """Request for relocation analysis."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    target_location: DateTimeLocation | None = None
    options: ChartOptions | None = None
    report_options: ReportOptions | None = None


class LunarAnalysisRequest(BaseModel):
    """Request for lunar analysis."""

    model_config = ConfigDict(extra="forbid")

    datetime_location: DateTimeLocation
    tradition: str | None = None
    language: Language | None = None
    report_options: ReportOptions | None = None


# Astrocartography - Additional endpoints


class AstrocartographyMapRequest(BaseModel):
    """Request for astrocartography map."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    map_options: dict[str, Any] | None = None
    visual_options: dict[str, Any] | None = None


class LocationAnalysisRequest(BaseModel):
    """Request for location analysis."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    location: dict[str, Any]
    analysis_options: dict[str, Any] | None = None
    language: Language | None = None


class SearchLocationsRequest(BaseModel):
    """Request for searching optimal locations."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    search_criteria: dict[str, Any] | None = None
    location_filters: dict[str, Any] | None = None
    result_options: dict[str, Any] | None = None
    language: Language | None = None


class CompareLocationsRequest(BaseModel):
    """Request for comparing locations."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    locations: list[dict[str, Any]]
    comparison_criteria: dict[str, Any] | None = None
    language: Language | None = None


class PowerZonesRequest(BaseModel):
    """Request for finding power zones."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    search_options: dict[str, Any] | None = None
    language: Language | None = None


class ParanMapRequest(BaseModel):
    """Request for paran map."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    paran_options: dict[str, Any] | None = None
    visual_options: dict[str, Any] | None = None


class AstrodynesRequest(BaseModel):
    """Request for astrodynes calculation."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    relocation: dict[str, Any] | None = None
    options: dict[str, Any] | None = None


class CompareAstrodynesRequest(BaseModel):
    """Request for comparing astrodynes across locations."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    locations: list[dict[str, Any]]
    options: dict[str, Any] | None = None


# Chinese - Additional endpoints


class ChineseSubject(BaseModel):
    """Subject with gender for Chinese astrology."""

    model_config = ConfigDict(extra="forbid")

    name: str | None = None
    birth_data: BirthData
    gender: Gender | None = None


class ChineseCompatibilityRequest(BaseModel):
    """Request for Chinese compatibility."""

    model_config = ConfigDict(extra="forbid")

    subjects: list[Subject]
    language: Language | None = "en"


class LuckPillarsRequest(BaseModel):
    """Request for luck pillars."""

    model_config = ConfigDict(extra="forbid")

    subject: ChineseSubject
    include_annual_pillars: bool | None = None
    years_ahead: int | None = None
    current_year: int | None = None
    language: Language | None = "en"


class MingGuaRequest(BaseModel):
    """Request for Ming Gua calculation."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    language: Language | None = "en"


class YearlyForecastRequest(BaseModel):
    """Request for yearly forecast."""

    model_config = ConfigDict(extra="forbid")

    subject: ChineseSubject
    forecast_year: int | None = None
    include_monthly: bool | None = None
    include_advice: bool | None = None
    language: Language | None = "en"


# Eclipses - Additional endpoints


class EclipseNatalCheckRequest(BaseModel):
    """Request for eclipse natal impact check."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    date_range: DateRange
    max_orb: float | None = None


class EclipseInterpretationRequest(BaseModel):
    """Request for eclipse interpretation."""

    model_config = ConfigDict(extra="forbid")

    eclipse_id: str
    birth_data: Subject | None = None
    language: Language | None = None
    include_house_themes: bool | None = None


# Horoscope - Text variants


class SignTextHoroscopeRequest(BaseModel):
    """Request for sign text horoscope."""

    model_config = ConfigDict(extra="forbid")

    sign: Sign
    date: str | None = None
    year: int | None = None
    month: int | None = None
    language: Language | None = "en"
    tradition: str | None = None
    minimum_strength: float | None = None
    format: TextFormat | None = None
    emoji: bool | None = None


class PersonalTextHoroscopeRequest(BaseModel):
    """Request for personal text horoscope."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    target_date: str | None = None
    horoscope_type: str | None = "daily"
    language: Language | None = "en"
    tradition: str | None = None
    include_transits: bool | None = None
    include_progressions: bool | None = None
    format: TextFormat | None = None
    emoji: bool | None = None


class ChineseBaziHoroscopeRequest(BaseModel):
    """Request for Chinese BaZi horoscope."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    year: int | None = None
    language: Language | None = "en"


# Lunar - Additional endpoints


class LunarPhasesRequest(BaseModel):
    """Request for precise lunar phases."""

    model_config = ConfigDict(extra="forbid")

    datetime_location: DateTimeLocation
    days_ahead: int | None = None


class LunarVoidOfCourseRequest(BaseModel):
    """Request for void of course status."""

    model_config = ConfigDict(extra="forbid")

    datetime_location: DateTimeLocation
    days_ahead: int | None = None
    use_modern_planets: bool | None = None


class LunarMansionsRequest(BaseModel):
    """Request for lunar mansions."""

    model_config = ConfigDict(extra="forbid")

    datetime_location: DateTimeLocation
    system: str | None = None
    days_ahead: int | None = None


class LunarEventsRequest(BaseModel):
    """Request for special lunar events."""

    model_config = ConfigDict(extra="forbid")

    datetime_location: DateTimeLocation
    days_ahead: int | None = None


# Traditional - Additional endpoints


class TraditionalAnalysisRequest(BaseModel):
    """Request for traditional analysis."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    options: ChartOptions | None = None
    orbs: dict[str, Any] | None = None


class AnnualProfectionRequest(BaseModel):
    """Request for annual profection."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    current_date: str | None = None
    current_age: int | None = None


class ProfectionTimelineRequest(BaseModel):
    """Request for profection timeline."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    start_age: int | None = None
    end_age: int | None = None


# Tarot - Additional endpoints


class TarotReportRequest(BaseModel):
    """Request for tarot report."""

    model_config = ConfigDict(extra="forbid")

    spread_type: TarotReportSpread | None = None
    life_area: str | None = None
    birth_data: DateTimeLocation | None = None
    partner_birth_data: DateTimeLocation | None = None
    use_reversals: bool | None = None
    tradition: TarotTradition | None = None
    include_dignities: bool | None = None
    include_timing: bool | None = None
    include_astro_context: bool | None = None
    include_birth_cards: bool | None = None
    interpretation_depth: TarotInterpretationDepth | None = None
    language: Language | None = "en"


class TarotQuintessenceRequest(BaseModel):
    """Request for tarot quintessence calculation."""

    model_config = ConfigDict(extra="forbid")

    cards: list[str]
    include_interpretation: bool | None = None


class TarotBirthCardsRequest(BaseModel):
    """Request for tarot birth cards."""

    model_config = ConfigDict(extra="forbid")

    birth_date: str | None = None
    include_interpretation: bool | None = None
    subject: Subject | None = None


class TarotDignitiesRequest(BaseModel):
    """Request for tarot elemental dignities."""

    model_config = ConfigDict(extra="forbid")

    cards: list[dict[str, Any]]
    spread_type: str | None = None


class TarotTimingRequest(BaseModel):
    """Request for tarot timing analysis."""

    model_config = ConfigDict(extra="forbid")

    cards: list[str]
    birth_data: DateTimeLocation | None = None
    question_type: str | None = None


class TarotOptimalTimesRequest(BaseModel):
    """Request for finding optimal times via tarot."""

    model_config = ConfigDict(extra="forbid")

    birth_data: DateTimeLocation
    question_type: str
    date_range: DateRange


class TarotNatalReportRequest(BaseModel):
    """Request for tarot natal/transit report."""

    model_config = ConfigDict(extra="forbid")

    birth_data: DateTimeLocation
    life_area: str | None = None
    include_timing: bool | None = None
    interpretation_depth: TarotInterpretationDepth | None = None
    language: Language | None = "en"


# Insights - Additional endpoints


class SingleSubjectRequest(BaseModel):
    """Generic single subject request."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    options: dict[str, Any] | None = None
    language: Language | None = "en"


class MultipleSubjectsRequest(BaseModel):
    """Generic multiple subjects request."""

    model_config = ConfigDict(extra="forbid")

    subjects: list[Subject]
    options: dict[str, Any] | None = None
    language: Language | None = "en"


class PetPersonalityRequest(BaseModel):
    """Request for pet personality analysis."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    pet_options: dict[str, Any] | None = None
    owner: Subject | None = None
    language: Language | None = "en"


class MultiPetRequest(BaseModel):
    """Request for multi-pet dynamics analysis."""

    model_config = ConfigDict(extra="forbid")

    subjects: list[Subject]
    options: dict[str, Any] | None = None
    pet_options: dict[str, Any] | None = None
    language: Language | None = "en"


class MarketTimingRequest(BaseModel):
    """Request for market timing analysis."""

    model_config = ConfigDict(extra="forbid")

    language: Language | None = "en"
    start_date: str | None = None
    end_date: str | None = None
    markets: list[str] | None = None


class GannAnalysisRequest(BaseModel):
    """Request for Gann cycles analysis."""

    model_config = ConfigDict(extra="forbid")

    symbol: str | None = None
    reference_date: str | None = None
    forecast_days: int | None = None
    language: Language | None = "en"


class BradleyRequest(BaseModel):
    """Request for Bradley siderograph."""

    model_config = ConfigDict(extra="forbid")

    language: Language | None = "en"
    birth_data: BirthData | None = None
    period: str | None = None
    market: str | None = None
    year: int | None = None
    analysis_date: str | None = None


class CryptoTimingRequest(BaseModel):
    """Request for crypto timing analysis."""

    model_config = ConfigDict(extra="forbid")

    language: Language | None = "en"
    cryptocurrency: str | None = None
    analysis_period_days: int | None = None
    include_volatility_forecast: bool | None = None


class ForexTimingRequest(BaseModel):
    """Request for forex timing analysis."""

    model_config = ConfigDict(extra="forbid")

    pair: str | None = None
    trading_session: str | None = None
    forecast_days: int | None = None
    language: Language | None = "en"


class BusinessTimingRequest(BaseModel):
    """Request for business timing analysis."""

    model_config = ConfigDict(extra="forbid")

    activities: list[str] | None = None
    start_date: str | None = None
    end_date: str | None = None
    company_data: DateTimeLocation | None = None
    language: Language | None = "en"


class BusinessMultipleRequest(BaseModel):
    """Request for business multiple subjects analysis."""

    model_config = ConfigDict(extra="forbid")

    subjects: list[Subject]
    options: dict[str, Any] | None = None
    business_options: dict[str, Any] | None = None
    language: Language | None = "en"


class BusinessSingleRequest(BaseModel):
    """Request for business single subject analysis."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    options: dict[str, Any] | None = None
    business_options: dict[str, Any] | None = None
    language: Language | None = "en"


# Numerology - Additional endpoints


class NumerologyCompatibilityRequest(BaseModel):
    """Request for numerology compatibility."""

    model_config = ConfigDict(extra="forbid")

    subjects: list[Subject]
    options: dict[str, Any] | None = None
    language: Language | None = "en"


# Render


class RenderOptions(BaseModel):
    """Options for chart rendering."""

    model_config = ConfigDict(extra="forbid")

    format: RenderFormat | None = None
    width: int | None = None
    scale: float | None = None
    quality: int | None = None
    theme: RenderTheme | None = None
    language: Language | None = None
    custom_colors: dict[str, str] | None = None


class RenderNatalRequest(BaseModel):
    """Request for rendering natal chart."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    options: ChartOptions | None = None
    render_options: RenderOptions | None = None


class RenderSynastryRequest(BaseModel):
    """Request for rendering synastry chart."""

    model_config = ConfigDict(extra="forbid")

    subject1: Subject
    subject2: Subject
    options: ChartOptions | None = None
    render_options: RenderOptions | None = None


class RenderCompositeRequest(BaseModel):
    """Request for rendering composite chart."""

    model_config = ConfigDict(extra="forbid")

    subject1: Subject
    subject2: Subject
    options: ChartOptions | None = None
    render_options: RenderOptions | None = None


class RenderTransitRequest(BaseModel):
    """Request for rendering transit chart."""

    model_config = ConfigDict(extra="forbid")

    natal_subject: Subject
    transit_datetime: DateTimeLocation
    options: ChartOptions | None = None
    render_options: RenderOptions | None = None


# Fengshui


class FlyingStarsChartRequest(BaseModel):
    """Request for flying stars chart."""

    model_config = ConfigDict(extra="forbid")

    facing_degrees: float
    period: int
    include_annual: bool | None = None
    include_monthly: bool | None = None
    analysis_date: str | None = None
    language: Language | None = None


# Horary


class HoraryChartRequest(BaseModel):
    """Request for horary chart."""

    model_config = ConfigDict(extra="forbid")

    question: str
    question_time: DateTimeLocation
    chart_options: ChartOptions | None = None
    options: dict[str, Any] | None = None


class HoraryAnalyzeRequest(BaseModel):
    """Request for horary question analysis."""

    model_config = ConfigDict(extra="forbid")

    question: str
    category: HoraryCategory
    subcategory: str | None = None
    question_time: DateTimeLocation
    chart_options: ChartOptions | None = None
    include_timing: bool | None = None
    extended_lunar_sequence: bool | None = None
    max_lookahead_degrees: float | None = None
    options: dict[str, Any] | None = None


class HoraryAspectsRequest(BaseModel):
    """Request for horary aspects."""

    model_config = ConfigDict(extra="forbid")

    question_time: DateTimeLocation
    max_lookahead_degrees: float | None = None
    include_separating: bool | None = None
    planets: list[str] | None = None
    chart_options: ChartOptions | None = None
    include_ingresses: bool | None = None
    include_stations: bool | None = None
    max_station_days: int | None = None


class HoraryFertilityRequest(BaseModel):
    """Request for horary fertility analysis."""

    model_config = ConfigDict(extra="forbid")

    question: str
    question_time: DateTimeLocation
    chart_options: ChartOptions | None = None
    include_timing: bool | None = None
    extended_lunar_sequence: bool | None = None
    max_lookahead_degrees: float | None = None
    include_all_planetary_aspects: bool | None = None


# Human Design


class HumanDesignOptions(BaseModel):
    """Options for Human Design calculations."""

    model_config = ConfigDict(extra="forbid")

    include_interpretations: bool | None = None
    include_design_chart: bool | None = None
    include_channels: bool | None = None
    include_definition_bridges: bool | None = None
    include_variables: bool | None = None


class HumanDesignRequest(BaseModel):
    """Request for Human Design bodygraph/type/design-date."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    options: dict[str, Any] | None = None
    hd_options: HumanDesignOptions | None = None


class HumanDesignTransitRequest(BaseModel):
    """Request for Human Design transit overlay."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    transit_datetime: str | None = None
    options: dict[str, Any] | None = None
    hd_options: HumanDesignOptions | None = None
    transit_options: dict[str, Any] | None = None


class HumanDesignCompatibilityRequest(BaseModel):
    """Request for Human Design compatibility."""

    model_config = ConfigDict(extra="forbid")

    subjects: list[Subject]
    options: dict[str, Any] | None = None
    hd_options: HumanDesignOptions | None = None


# Kabbalah


class TreeOfLifeChartRequest(BaseModel):
    """Request for Tree of Life chart."""

    model_config = ConfigDict(extra="forbid")

    birth_data: DateTimeLocation
    system: KabbalahSystem | None = None
    include_daat: bool | None = None
    include_paths: bool | None = None
    include_interpretations: bool | None = None
    language: Language | None = None
    tradition: str | None = None


class BirthAngelsRequest(BaseModel):
    """Request for birth angels."""

    model_config = ConfigDict(extra="forbid")

    birth_data: DateTimeLocation
    include_secondary: bool | None = None
    include_tertiary: bool | None = None
    include_interpretations: bool | None = None
    language: Language | None = None


class TikkunRequest(BaseModel):
    """Request for Tikkun analysis."""

    model_config = ConfigDict(extra="forbid")

    birth_data: DateTimeLocation
    method: TikkunMethod | None = None
    include_interpretations: bool | None = None
    language: Language | None = None


class GematriaRequest(BaseModel):
    """Request for Gematria calculation."""

    model_config = ConfigDict(extra="forbid")

    text: str
    methods: list[GematriaMethod] | None = None
    find_equivalents: bool | None = None
    language: Language | None = None


# Palmistry


class PalmAnalysisRequest(BaseModel):
    """Request for palm analysis."""

    model_config = ConfigDict(extra="forbid")

    image_url: str | None = None
    image_base64: str | None = None
    return_visualization: bool | None = None
    include_quality: bool | None = None


class PalmReadingRequest(BaseModel):
    """Request for palm reading."""

    model_config = ConfigDict(extra="forbid")

    image_url: str | None = None
    image_base64: str | None = None
    return_visualization: bool | None = None
    language: Language | None = None
    include_raw_data: bool | None = None


class PalmAstroRequest(BaseModel):
    """Request for palm-astrology integration."""

    model_config = ConfigDict(extra="forbid")

    image_url: str | None = None
    image_base64: str | None = None
    birth_data: BirthData | None = None
    return_visualization: bool | None = None
    language: Language | None = None


class PalmCompatibilityRequest(BaseModel):
    """Request for palm compatibility."""

    model_config = ConfigDict(extra="forbid")

    palm_a_url: str | None = None
    palm_a_base64: str | None = None
    palm_b_url: str | None = None
    palm_b_base64: str | None = None
    return_visualization: bool | None = None
    language: Language | None = None


# PDF


class PdfPageSettings(BaseModel):
    """PDF page settings."""

    model_config = ConfigDict(extra="forbid")

    page_size: PdfPageSize | None = None
    orientation: PdfOrientation | None = None
    margins: dict[str, float] | None = None


class PdfStyle(BaseModel):
    """PDF style options."""

    model_config = ConfigDict(extra="forbid")

    theme: PdfTheme | None = None
    accent_color: str | None = None
    font_style: PdfFontStyle | None = None
    font_size_base: int | None = None


class PdfBranding(BaseModel):
    """PDF branding options."""

    model_config = ConfigDict(extra="forbid")

    logo_url: str | None = None
    company_name: str | None = None
    company_website: str | None = None
    primary_brand_color: str | None = None


class PdfOptions(BaseModel):
    """PDF generation options."""

    model_config = ConfigDict(extra="forbid")

    page_settings: PdfPageSettings | None = None
    style: PdfStyle | None = None
    branding: PdfBranding | None = None
    language: Language | None = None
    include_cover_page: bool | None = None
    include_table_of_contents: bool | None = None
    watermark_text: str | None = None


class PdfNatalReportRequest(BaseModel):
    """Request for natal report PDF."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    tradition: str | None = None
    chart_options: ChartOptions | None = None
    pdf_options: PdfOptions | None = None
    include_chart_svg: bool | None = None
    chart_theme: str | None = None


class PdfDailyHoroscopeRequest(BaseModel):
    """Request for daily horoscope PDF."""

    model_config = ConfigDict(extra="forbid")

    sign: PdfSign | None = None
    target_date: str | None = None
    subject: Subject | None = None
    pdf_options: PdfOptions | None = None
    include_chart_image: bool | None = None
    chart_theme: str | None = None


class PdfWeeklyHoroscopeRequest(BaseModel):
    """Request for weekly horoscope PDF."""

    model_config = ConfigDict(extra="forbid")

    sign: PdfSign | None = None
    week_start: str | None = None
    subject: Subject | None = None
    pdf_options: PdfOptions | None = None
    include_chart_image: bool | None = None
    chart_theme: str | None = None


# Vedic


class VedicOptions(BaseModel):
    """Options for Vedic calculations."""

    model_config = ConfigDict(extra="forbid")

    ayanamsa: VedicAyanamsa | None = None
    node_type: VedicNodeType | None = None
    bhava_system: VedicBhavaSystem | None = None
    language: Language | None = None
    include_upagrahas: bool | None = None
    include_arudha_padas: bool | None = None
    precision: int | None = None


class VedicRequest(BaseModel):
    """Generic Vedic request with subject."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    options: VedicOptions | None = None


class VedicKundliRequest(BaseModel):
    """Request for Kundli matching."""

    model_config = ConfigDict(extra="forbid")

    groom: Subject
    bride: Subject
    include_manglik: bool | None = None
    options: VedicOptions | None = None


class VedicDivisionalChartRequest(BaseModel):
    """Request for divisional charts."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    charts: list[VedicDivisionalChart] | None = None
    options: VedicOptions | None = None


class VedicPanchangRequest(BaseModel):
    """Request for Panchang."""

    model_config = ConfigDict(extra="forbid")

    datetime_location: DateTimeLocation
    options: VedicOptions | None = None


class VedicDashaRequest(BaseModel):
    """Request for Vimshottari/Yogini dasha."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    dasha_level: VedicDashaLevel | None = None
    target_date: str | None = None
    years_ahead: int | None = None
    options: VedicOptions | None = None


class VedicRemediesRequest(BaseModel):
    """Request for Vedic remedies."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    remedy_type: VedicRemedyType | None = None
    options: VedicOptions | None = None


class VedicTransitRequest(BaseModel):
    """Request for Vedic transit."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    transit_date: str | None = None
    options: VedicOptions | None = None


class VedicSadeSatiRequest(BaseModel):
    """Request for Sade Sati analysis."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    check_date: str | None = None
    include_remedies: bool | None = None
    options: VedicOptions | None = None


class VedicYogaRequest(BaseModel):
    """Request for yoga analysis."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    include_categories: list[VedicYogaCategory] | None = None
    options: VedicOptions | None = None


class VedicCharaDashaRequest(BaseModel):
    """Request for Chara Dasha."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    calculation_years: int | None = None
    include_antardashas: bool | None = None
    include_karakas: bool | None = None
    options: VedicOptions | None = None


class VedicKPRequest(BaseModel):
    """Request for KP system calculation."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    include_significators: bool | None = None
    include_ruling_planets: bool | None = None


class VedicVarshaphalRequest(BaseModel):
    """Request for Varshaphal calculation."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    target_year: int
    options: VedicOptions | None = None


class VedicFestivalRequest(BaseModel):
    """Request for festival calendar."""

    model_config = ConfigDict(extra="forbid")

    year: int
    region: str | None = None
    festival_type: VedicFestivalType | None = None
    language: Language | None = None


class VedicRegionalPanchangRequest(BaseModel):
    """Request for regional Panchang."""

    model_config = ConfigDict(extra="forbid")

    year: int
    month: int
    day: int
    hour: int | None = None
    minute: int | None = None
    latitude: float
    longitude: float
    timezone: str
    region: str | None = None
    language: Language | None = None
    ayanamsa: VedicAyanamsa | None = None


class VedicChartOptions(BaseModel):
    """Vedic chart rendering options."""

    model_config = ConfigDict(extra="forbid")

    ayanamsa: VedicAyanamsa | None = None
    node_type: VedicNodeType | None = None
    precision: int | None = None
    house_system: str | None = None


class VedicSVGOptions(BaseModel):
    """Vedic SVG rendering options."""

    model_config = ConfigDict(extra="forbid")

    theme: VedicChartTheme | None = None
    sign_format: VedicSignFormat | None = None
    show_degrees: bool | None = None
    show_retrograde: bool | None = None
    show_dignity: bool | None = None
    font_size: int | None = None
    use_glyphs: bool | None = None


class VedicChartRequest(BaseModel):
    """Request for Vedic chart SVG."""

    model_config = ConfigDict(extra="forbid")

    subject: Subject
    style: VedicChartStyle | None = None
    chart_options: VedicChartOptions | None = None
    svg_options: VedicSVGOptions | None = None


# Ziwei


class ZiweiChartRequest(BaseModel):
    """Request for Zi Wei Dou Shu chart."""

    model_config = ConfigDict(extra="forbid")

    name: str | None = None
    birth_data: BirthData
    gender: Gender
    language: Language | None = None