astroapi-io-client 0.2.9__tar.gz → 0.2.12__tar.gz

{astroapi_io_client-0.2.9 → astroapi_io_client-0.2.12}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astroapi-io-client
-Version: 0.2.9
+Version: 0.2.12
 Summary: Synchronous Python client for the AstroAPI.io calculation gateway
 License-Expression: ISC
 Classifier: Programming Language :: Python :: 3
@@ -14,13 +14,13 @@ Dynamic: license-file
 
 # AstroAPI.io Python client
 
-The R201 source client `astroapi-io-client==0.2.9` covers all forty-nine calculation routes: forty-eight standard operations plus the separate Pro Nakshatra Timeline. This package version is the verified R201 client publication; service availability still requires R201 promotion. Minor-body calculations are not part of the contract.
+The R204 source client version `astroapi-io-client==0.2.12` covers all fifty-two calculation routes: fifty-one standard operations plus the separate Pro Nakshatra Timeline. Package availability does not deploy source-only routes; service availability still requires R204 promotion. Minor-body calculations are not part of the contract.
 
 A synchronous client for Python 3.10+, with no runtime dependencies.
 The package import is `astroapi_client`; the distribution name is
-`astroapi-io-client`. Version 0.2.9 is the R201 source client; package availability never implies that source-only R201 API capabilities are deployed.
+`astroapi-io-client`. Version 0.2.12 is the R204 source client; package availability never implies that source-only R204 API capabilities are deployed.
 
-Install from PyPI with `python -m pip install astroapi-io-client==0.2.9`, or install the current source from a local checkout using `python -m pip install ./clients/python`.
+Install version 0.2.12 with `python -m pip install astroapi-io-client==0.2.12`, or install the R204 source from a local checkout using `python -m pip install ./clients/python`.
 Building needs setuptools and wheel; the installed client uses only the standard
 library. Keep API credentials in trusted server or command-line environments.
 
@@ -102,6 +102,9 @@ Type hints describe the server contract and do not perform response validation.
 | `house_placement_stability` **beta** | `calculateHousePlacementStability` | exact birth and explicit tropical/sidereal profile | exact assignments, unweighted agreement ratios, and deterministic equivalence groups across available 12-house systems |
 | `aspect_policy_stability` **beta** | `calculateAspectPolicyStability` | exact birth, explicit profile, optional 3–10 points, and 2–4 named aspect policies | admission reasons, signed orb margins, set fingerprints, and deterministic equivalence groups |
 | `house_boundary_proximity` **beta** | `calculateHouseBoundaryProximity` | exact birth, explicit profile, optional 1–10 points and 0.1–10° threshold | exact two-sided cusp clearance, normalized position, nearest-boundary ties, and explicit no-fallback geometry failures |
+| `location_precision_audit` **beta** | `calculateLocationPrecisionAudit` | exact birth, one explicit 12-house system, 0.1–500 km radius, optional 1–10 points | nine sample rows, planet-house stability, maximum angle/cusp displacement, and explicit no-fallback geometry failures |
+| `location_transition_scan` **beta** | `calculateLocationTransitionScan` | exact birth, one explicit 12-house system, 1–500 km maximum radius, optional 1–10 points | 65 checkpoints and per-bearing first observed angle-sign, cusp-sign, and planet-house transition brackets or explicit failure states |
+| `chart_uncertainty_envelope` **beta** | `calculateChartUncertaintyEnvelope` | exact birth, one explicit 12-house system, 5–180 minute uncertainty, 0.1–500 km radius, optional 1–10 points | full-factorial 7-time × 9-location evidence separating time-axis, location-axis, combined, and interaction-only observed variation |
 | `synastry_svg` **beta** | `calculateSynastrySvg` | two births; optional zodiac/houses/theme/aspects/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `transit_svg` **beta** | `calculateTransitSvg` | birth and transit date; optional display controls/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `natal_report` **beta** | `calculateNatalReport` | birth; optional zodiac/houses/theme/SVG/download | `result["html"]`, source-linked `result["facts"]`, optional `result["download"]` |

{astroapi_io_client-0.2.9 → astroapi_io_client-0.2.12}/README.md

@@ -1,12 +1,12 @@
 # AstroAPI.io Python client
 
-The R201 source client `astroapi-io-client==0.2.9` covers all forty-nine calculation routes: forty-eight standard operations plus the separate Pro Nakshatra Timeline. This package version is the verified R201 client publication; service availability still requires R201 promotion. Minor-body calculations are not part of the contract.
+The R204 source client version `astroapi-io-client==0.2.12` covers all fifty-two calculation routes: fifty-one standard operations plus the separate Pro Nakshatra Timeline. Package availability does not deploy source-only routes; service availability still requires R204 promotion. Minor-body calculations are not part of the contract.
 
 A synchronous client for Python 3.10+, with no runtime dependencies.
 The package import is `astroapi_client`; the distribution name is
-`astroapi-io-client`. Version 0.2.9 is the R201 source client; package availability never implies that source-only R201 API capabilities are deployed.
+`astroapi-io-client`. Version 0.2.12 is the R204 source client; package availability never implies that source-only R204 API capabilities are deployed.
 
-Install from PyPI with `python -m pip install astroapi-io-client==0.2.9`, or install the current source from a local checkout using `python -m pip install ./clients/python`.
+Install version 0.2.12 with `python -m pip install astroapi-io-client==0.2.12`, or install the R204 source from a local checkout using `python -m pip install ./clients/python`.
 Building needs setuptools and wheel; the installed client uses only the standard
 library. Keep API credentials in trusted server or command-line environments.
 
@@ -88,6 +88,9 @@ Type hints describe the server contract and do not perform response validation.
 | `house_placement_stability` **beta** | `calculateHousePlacementStability` | exact birth and explicit tropical/sidereal profile | exact assignments, unweighted agreement ratios, and deterministic equivalence groups across available 12-house systems |
 | `aspect_policy_stability` **beta** | `calculateAspectPolicyStability` | exact birth, explicit profile, optional 3–10 points, and 2–4 named aspect policies | admission reasons, signed orb margins, set fingerprints, and deterministic equivalence groups |
 | `house_boundary_proximity` **beta** | `calculateHouseBoundaryProximity` | exact birth, explicit profile, optional 1–10 points and 0.1–10° threshold | exact two-sided cusp clearance, normalized position, nearest-boundary ties, and explicit no-fallback geometry failures |
+| `location_precision_audit` **beta** | `calculateLocationPrecisionAudit` | exact birth, one explicit 12-house system, 0.1–500 km radius, optional 1–10 points | nine sample rows, planet-house stability, maximum angle/cusp displacement, and explicit no-fallback geometry failures |
+| `location_transition_scan` **beta** | `calculateLocationTransitionScan` | exact birth, one explicit 12-house system, 1–500 km maximum radius, optional 1–10 points | 65 checkpoints and per-bearing first observed angle-sign, cusp-sign, and planet-house transition brackets or explicit failure states |
+| `chart_uncertainty_envelope` **beta** | `calculateChartUncertaintyEnvelope` | exact birth, one explicit 12-house system, 5–180 minute uncertainty, 0.1–500 km radius, optional 1–10 points | full-factorial 7-time × 9-location evidence separating time-axis, location-axis, combined, and interaction-only observed variation |
 | `synastry_svg` **beta** | `calculateSynastrySvg` | two births; optional zodiac/houses/theme/aspects/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `transit_svg` **beta** | `calculateTransitSvg` | birth and transit date; optional display controls/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `natal_report` **beta** | `calculateNatalReport` | birth; optional zodiac/houses/theme/SVG/download | `result["html"]`, source-linked `result["facts"]`, optional `result["download"]` |

{astroapi_io_client-0.2.9 → astroapi_io_client-0.2.12}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "astroapi-io-client"
-version = "0.2.9"
+version = "0.2.12"
 description = "Synchronous Python client for the AstroAPI.io calculation gateway"
 readme = "README.md"
 license = "ISC"

{astroapi_io_client-0.2.9 → astroapi_io_client-0.2.12}/src/astroapi_client/__init__.py

@@ -17,7 +17,7 @@ from .types import (
     GeographicLocation, RelocationChartInput, AstrocartographyBody, AstrocartographyInput,
     EclipseType, EclipseGeometryInput, EclipseObserverSnapshot, EclipseEvent, EclipseGeometryResponse, MoonPhaseSector, ElectionalAspectFilter,
     ElectionalFilters, ElectionalSearchInput,
-    EventRule, EventRuleSearchInput, ConventionProfile, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput, CivilTimeAuditInput, ChartInputReadinessExactTime, ChartInputReadinessApproximateTime, ChartInputReadinessUnknownTime, ChartInputReadinessBirthTime, ChartInputReadinessInput, HouseSystemReadinessInput, HousePlacementStabilityInput, AspectPolicyStabilityPoint, AspectPolicyStabilityPolicy, AspectPolicyStabilityInput, HouseBoundaryProximityPoint, HouseBoundaryProximityInput,
+    EventRule, EventRuleSearchInput, ConventionProfile, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput, CivilTimeAuditInput, ChartInputReadinessExactTime, ChartInputReadinessApproximateTime, ChartInputReadinessUnknownTime, ChartInputReadinessBirthTime, ChartInputReadinessInput, HouseSystemReadinessInput, HousePlacementStabilityInput, AspectPolicyStabilityPoint, AspectPolicyStabilityPolicy, AspectPolicyStabilityInput, HouseBoundaryProximityPoint, HouseBoundaryProximityInput, LocationPrecisionAuditPoint, LocationPrecisionAuditHouseSystem, LocationPrecisionAuditProfile, LocationPrecisionAuditInput, LocationTransitionScanPoint, LocationTransitionScanHouseSystem, LocationTransitionScanProfile, LocationTransitionScanInput, ChartUncertaintyEnvelopePoint, ChartUncertaintyEnvelopeHouseSystem, ChartUncertaintyEnvelopeProfile, ChartUncertaintyEnvelopeInput,
     NatalAnalysisAspectName, NatalAnalysisAspectOption, NatalAnalysisInput,
     AshtakootaInput, AshtakavargaInput, NumerologyInput, PlanetaryHoursInput,
     FixedStar, FixedStarsInput,
@@ -30,7 +30,7 @@ from .types import (
     PlaceSearchInput, TimezoneResolveInput, NatalContextInput,
 )
 
-__version__ = "0.2.9"
+__version__ = "0.2.12"
 __all__ = [
     "NumerologyInput", "verify_calculation_receipt",
     "AstroAPIClient", "AstroAPIError", "ClientBusyError", "HTTPError", "DavisonInput",
@@ -45,7 +45,7 @@ __all__ = [
     "GeographicLocation", "RelocationChartInput", "AstrocartographyBody", "AstrocartographyInput",
     "EclipseType", "EclipseGeometryInput", "EclipseObserverSnapshot", "EclipseEvent", "EclipseGeometryResponse", "MoonPhaseSector", "ElectionalAspectFilter",
     "ElectionalFilters", "ElectionalSearchInput",
-    "EventRule", "EventRuleSearchInput", "ConventionProfile", "ConventionCompareInput", "ReleaseCompareInput", "ChartRobustnessInput", "CivilTimeAuditInput", "ChartInputReadinessExactTime", "ChartInputReadinessApproximateTime", "ChartInputReadinessUnknownTime", "ChartInputReadinessBirthTime", "ChartInputReadinessInput", "HouseSystemReadinessInput", "HousePlacementStabilityInput", "AspectPolicyStabilityPoint", "AspectPolicyStabilityPolicy", "AspectPolicyStabilityInput", "HouseBoundaryProximityPoint", "HouseBoundaryProximityInput",
+    "EventRule", "EventRuleSearchInput", "ConventionProfile", "ConventionCompareInput", "ReleaseCompareInput", "ChartRobustnessInput", "CivilTimeAuditInput", "ChartInputReadinessExactTime", "ChartInputReadinessApproximateTime", "ChartInputReadinessUnknownTime", "ChartInputReadinessBirthTime", "ChartInputReadinessInput", "HouseSystemReadinessInput", "HousePlacementStabilityInput", "AspectPolicyStabilityPoint", "AspectPolicyStabilityPolicy", "AspectPolicyStabilityInput", "HouseBoundaryProximityPoint", "HouseBoundaryProximityInput", "LocationPrecisionAuditPoint", "LocationPrecisionAuditHouseSystem", "LocationPrecisionAuditProfile", "LocationPrecisionAuditInput", "LocationTransitionScanPoint", "LocationTransitionScanHouseSystem", "LocationTransitionScanProfile", "LocationTransitionScanInput", "ChartUncertaintyEnvelopePoint", "ChartUncertaintyEnvelopeHouseSystem", "ChartUncertaintyEnvelopeProfile", "ChartUncertaintyEnvelopeInput",
     "NatalAnalysisAspectName", "NatalAnalysisAspectOption", "NatalAnalysisInput",
     "AshtakootaInput", "AshtakavargaInput", "PlanetaryHoursInput",
     "FixedStar", "FixedStarsInput",

{astroapi_io_client-0.2.9 → astroapi_io_client-0.2.12}/src/astroapi_client/_validation.py

@@ -27,6 +27,12 @@ _CONFIGURABLE_ASPECTS = {
     "conjunction", "semisextile", "semisquare", "sextile", "quintile",
     "square", "trine", "sesquiquadrate", "biquintile", "quincunx", "opposition",
 }
+_NATAL_HOUSE_SYSTEMS = {
+    "equal", "whole_sign", "placidus", "porphyry", "meridian", "campanus",
+    "regiomontanus", "alcabitius", "koch", "morinus", "topocentric", "sripati",
+    "vehlow", "horizon", "krusinski", "sunshine", "sunshine_alt", "savard",
+    "pullen_sd", "pullen_sr", "carter", "apc", "equal_mc", "natural",
+}
 
 
 def _invalid(message: str = "Request does not match the route's supported input fields.") -> None:
@@ -746,6 +752,57 @@ def encode_request(route: str, payload: Any) -> bytes:
                     or not 0.1 <= threshold <= 10.0
                     or abs(threshold * 10 - round(threshold * 10)) > 1e-9):
                 _invalid("threshold_degrees must be 0.1 through 10.0 in 0.1 degree increments.")
+    elif route == "location-precision-audit":
+        _object(data, {"birth", "profile", "radius_km", "points"}, {"birth", "profile", "radius_km"})
+        birth = _object(data["birth"], {"date", "time", "timezone", "lat", "lon"}, {"date", "time", "timezone", "lat", "lon"})
+        _birth(birth)
+        profile = _object(data["profile"], {"zodiac", "ayanamsa", "house_system"}, {"zodiac", "house_system"})
+        _enum(profile["zodiac"], {"tropical", "sidereal"}, "zodiac must be tropical or sidereal.")
+        _enum(profile["house_system"], _NATAL_HOUSE_SYSTEMS, "house_system must be a documented 12-house system.")
+        if profile["zodiac"] == "tropical" and "ayanamsa" in profile:
+            _invalid("tropical profiles cannot include ayanamsa.")
+        if profile["zodiac"] == "sidereal" and ("ayanamsa" not in profile or profile["ayanamsa"] not in _AYANAMSAS):
+            _invalid("sidereal profiles require a supported ayanamsa.")
+        radius = data["radius_km"]
+        if type(radius) not in {int, float} or not math.isfinite(radius) or not 0.1 <= radius <= 500.0:
+            _invalid("radius_km must be a finite number from 0.1 through 500.")
+        if "points" in data:
+            _unique_enum_list(data["points"], _PLANETARY_EVENT_BODIES, 10, "points")
+    elif route == "location-transition-scan":
+        _object(data, {"birth", "profile", "max_radius_km", "points"}, {"birth", "profile", "max_radius_km"})
+        birth = _object(data["birth"], {"date", "time", "timezone", "lat", "lon"}, {"date", "time", "timezone", "lat", "lon"})
+        _birth(birth)
+        profile = _object(data["profile"], {"zodiac", "ayanamsa", "house_system"}, {"zodiac", "house_system"})
+        _enum(profile["zodiac"], {"tropical", "sidereal"}, "zodiac must be tropical or sidereal.")
+        _enum(profile["house_system"], _NATAL_HOUSE_SYSTEMS, "house_system must be a documented 12-house system.")
+        if profile["zodiac"] == "tropical" and "ayanamsa" in profile:
+            _invalid("tropical profiles cannot include ayanamsa.")
+        if profile["zodiac"] == "sidereal" and ("ayanamsa" not in profile or profile["ayanamsa"] not in _AYANAMSAS):
+            _invalid("sidereal profiles require a supported ayanamsa.")
+        radius = data["max_radius_km"]
+        if type(radius) not in {int, float} or not math.isfinite(radius) or not 1.0 <= radius <= 500.0:
+            _invalid("max_radius_km must be a finite number from 1 through 500.")
+        if "points" in data:
+            _unique_enum_list(data["points"], _PLANETARY_EVENT_BODIES, 10, "points")
+    elif route == "chart-uncertainty-envelope":
+        _object(data, {"birth", "profile", "time_uncertainty_minutes", "location_radius_km", "points"}, {"birth", "profile", "time_uncertainty_minutes", "location_radius_km"})
+        birth = _object(data["birth"], {"date", "time", "timezone", "lat", "lon"}, {"date", "time", "timezone", "lat", "lon"})
+        _birth(birth)
+        profile = _object(data["profile"], {"zodiac", "ayanamsa", "house_system"}, {"zodiac", "house_system"})
+        _enum(profile["zodiac"], {"tropical", "sidereal"}, "zodiac must be tropical or sidereal.")
+        _enum(profile["house_system"], _NATAL_HOUSE_SYSTEMS, "house_system must be a documented 12-house system.")
+        if profile["zodiac"] == "tropical" and "ayanamsa" in profile:
+            _invalid("tropical profiles cannot include ayanamsa.")
+        if profile["zodiac"] == "sidereal" and ("ayanamsa" not in profile or profile["ayanamsa"] not in _AYANAMSAS):
+            _invalid("sidereal profiles require a supported ayanamsa.")
+        uncertainty = data["time_uncertainty_minutes"]
+        if type(uncertainty) is not int or not 5 <= uncertainty <= 180 or uncertainty % 5:
+            _invalid("time_uncertainty_minutes must be an integer multiple of 5 from 5 through 180.")
+        radius = data["location_radius_km"]
+        if type(radius) not in {int, float} or not math.isfinite(radius) or not 0.1 <= radius <= 500.0:
+            _invalid("location_radius_km must be a finite number from 0.1 through 500.")
+        if "points" in data:
+            _unique_enum_list(data["points"], _PLANETARY_EVENT_BODIES, 10, "points")
     elif route in {"house-system-readiness", "house-placement-stability"}:
         _object(data, {"birth", "profile"}, {"birth", "profile"})
         birth = _object(data["birth"], {"date", "time", "timezone", "lat", "lon"}, {"date", "time", "timezone", "lat", "lon"})

{astroapi_io_client-0.2.9 → astroapi_io_client-0.2.12}/src/astroapi_client/client.py

@@ -32,7 +32,7 @@ from .types import (
     MoonPhaseInput, MoonPhaseResponse, DavisonInput, PlanetaryEventsInput, PlanetaryEventsResponse,
     HouseIngressesInput, HouseIngressesResponse,
     AspectWindowsInput, AspectWindowsResponse,
-    EventRuleSearchInput, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput, CivilTimeAuditInput, ChartInputReadinessInput, HouseSystemReadinessInput, HousePlacementStabilityInput, AspectPolicyStabilityInput, HouseBoundaryProximityInput,
+    EventRuleSearchInput, ConventionCompareInput, ReleaseCompareInput, ChartRobustnessInput, CivilTimeAuditInput, ChartInputReadinessInput, HouseSystemReadinessInput, HousePlacementStabilityInput, AspectPolicyStabilityInput, HouseBoundaryProximityInput, LocationPrecisionAuditInput, LocationTransitionScanInput, ChartUncertaintyEnvelopeInput,
     EventCalendarInput, SynastrySvgInput, TransitSvgInput, NatalReportInput,
     BirthTimeSensitivityInput, RelocationChartInput, AstrocartographyInput,
     PlaceSearchInput, TimezoneResolveInput, NatalContextInput,
@@ -181,7 +181,7 @@ def _perform(
             "Content-Type": "application/json",
             "Accept": "application/json",
             "Accept-Encoding": "identity",
-            "User-Agent": "astroapi-io-client/0.2.9",
+            "User-Agent": "astroapi-io-client/0.2.12",
             "Connection": "close",
             **({"X-AstroAPI-Receipt": "v1"} if request_receipt else {}),
         })
@@ -285,7 +285,7 @@ class AstroAPIClient:
 
     def _request(self, route: str, payload: object) -> JSONResponse:
         body = encode_request(route, payload)
-        timeout = (self._timeline_timeout if route in {"nakshatra-timeline", "birth-time-sensitivity", "chart-robustness", "chart-input-readiness", "house-system-readiness", "house-placement-stability", "house-boundary-proximity"}
+        timeout = (self._timeline_timeout if route in {"nakshatra-timeline", "birth-time-sensitivity", "chart-robustness", "chart-input-readiness", "house-system-readiness", "house-placement-stability", "house-boundary-proximity", "location-precision-audit", "location-transition-scan", "chart-uncertainty-envelope"}
                    else self._planetary_events_timeout if route in {"planetary-events", "house-ingresses", "eclipse-geometry", "electional-search", "event-rule-search"}
                    else self._aspect_windows_timeout if route == "aspect-windows"
                    else self._timeout)
@@ -452,6 +452,18 @@ class AstroAPIClient:
         """BETA: audit exact two-sided cusp clearance across 12-house systems."""
         return self._request("house-boundary-proximity", payload)
 
+    def location_precision_audit(self, payload: LocationPrecisionAuditInput) -> JSONResponse:
+        """BETA: audit coordinate precision at a center plus eight perimeter samples."""
+        return self._request("location-precision-audit", payload)
+
+    def location_transition_scan(self, payload: LocationTransitionScanInput) -> JSONResponse:
+        """BETA: scan radial checkpoints for observed sign and house transitions."""
+        return self._request("location-transition-scan", payload)
+
+    def chart_uncertainty_envelope(self, payload: ChartUncertaintyEnvelopeInput) -> JSONResponse:
+        """BETA: separate sampled time, location, and combined chart variation."""
+        return self._request("chart-uncertainty-envelope", payload)
+
     def synastry_svg(self, payload: SynastrySvgInput) -> JSONResponse:
         """BETA: original deterministic double-wheel relationship SVG."""
         return self._request("synastry-svg", payload)

{astroapi_io_client-0.2.9 → astroapi_io_client-0.2.12}/src/astroapi_client/types.py

@@ -436,6 +436,65 @@ class HouseBoundaryProximityInput(_HouseBoundaryProximityRequired, total=False):
     threshold_degrees: float
 
 
+LocationPrecisionAuditPoint = HouseBoundaryProximityPoint
+LocationPrecisionAuditHouseSystem = Literal[
+    "equal", "whole_sign", "placidus", "porphyry", "meridian", "campanus",
+    "regiomontanus", "alcabitius", "koch", "morinus", "topocentric", "sripati",
+    "vehlow", "horizon", "krusinski", "sunshine", "sunshine_alt", "savard",
+    "pullen_sd", "pullen_sr", "carter", "apc", "equal_mc", "natural",
+]
+
+
+class _LocationPrecisionAuditProfileRequired(TypedDict):
+    zodiac: Zodiac
+    house_system: LocationPrecisionAuditHouseSystem
+
+
+class LocationPrecisionAuditProfile(_LocationPrecisionAuditProfileRequired, total=False):
+    ayanamsa: Ayanamsa
+
+
+class _LocationPrecisionAuditRequired(TypedDict):
+    birth: BirthInput
+    profile: LocationPrecisionAuditProfile
+    radius_km: float
+
+
+class LocationPrecisionAuditInput(_LocationPrecisionAuditRequired, total=False):
+    points: list[LocationPrecisionAuditPoint]
+
+
+LocationTransitionScanPoint = LocationPrecisionAuditPoint
+LocationTransitionScanHouseSystem = LocationPrecisionAuditHouseSystem
+LocationTransitionScanProfile = LocationPrecisionAuditProfile
+
+
+class _LocationTransitionScanRequired(TypedDict):
+    birth: BirthInput
+    profile: LocationTransitionScanProfile
+    max_radius_km: float
+
+
+class LocationTransitionScanInput(_LocationTransitionScanRequired, total=False):
+    points: list[LocationTransitionScanPoint]
+
+
+ChartUncertaintyEnvelopePoint = LocationPrecisionAuditPoint
+ChartUncertaintyEnvelopeHouseSystem = LocationPrecisionAuditHouseSystem
+ChartUncertaintyEnvelopeProfile = LocationPrecisionAuditProfile
+
+
+class _ChartUncertaintyEnvelopeRequired(TypedDict):
+    birth: BirthInput
+    profile: ChartUncertaintyEnvelopeProfile
+    time_uncertainty_minutes: int
+    location_radius_km: float
+
+
+class ChartUncertaintyEnvelopeInput(_ChartUncertaintyEnvelopeRequired, total=False):
+    points: list[ChartUncertaintyEnvelopePoint]
+
+
 class ReleaseCompareInput(TypedDict):
     releases: list[JSONResponse]
 

{astroapi_io_client-0.2.9 → astroapi_io_client-0.2.12}/src/astroapi_io_client.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: astroapi-io-client
-Version: 0.2.9
+Version: 0.2.12
 Summary: Synchronous Python client for the AstroAPI.io calculation gateway
 License-Expression: ISC
 Classifier: Programming Language :: Python :: 3
@@ -14,13 +14,13 @@ Dynamic: license-file
 
 # AstroAPI.io Python client
 
-The R201 source client `astroapi-io-client==0.2.9` covers all forty-nine calculation routes: forty-eight standard operations plus the separate Pro Nakshatra Timeline. This package version is the verified R201 client publication; service availability still requires R201 promotion. Minor-body calculations are not part of the contract.
+The R204 source client version `astroapi-io-client==0.2.12` covers all fifty-two calculation routes: fifty-one standard operations plus the separate Pro Nakshatra Timeline. Package availability does not deploy source-only routes; service availability still requires R204 promotion. Minor-body calculations are not part of the contract.
 
 A synchronous client for Python 3.10+, with no runtime dependencies.
 The package import is `astroapi_client`; the distribution name is
-`astroapi-io-client`. Version 0.2.9 is the R201 source client; package availability never implies that source-only R201 API capabilities are deployed.
+`astroapi-io-client`. Version 0.2.12 is the R204 source client; package availability never implies that source-only R204 API capabilities are deployed.
 
-Install from PyPI with `python -m pip install astroapi-io-client==0.2.9`, or install the current source from a local checkout using `python -m pip install ./clients/python`.
+Install version 0.2.12 with `python -m pip install astroapi-io-client==0.2.12`, or install the R204 source from a local checkout using `python -m pip install ./clients/python`.
 Building needs setuptools and wheel; the installed client uses only the standard
 library. Keep API credentials in trusted server or command-line environments.
 
@@ -102,6 +102,9 @@ Type hints describe the server contract and do not perform response validation.
 | `house_placement_stability` **beta** | `calculateHousePlacementStability` | exact birth and explicit tropical/sidereal profile | exact assignments, unweighted agreement ratios, and deterministic equivalence groups across available 12-house systems |
 | `aspect_policy_stability` **beta** | `calculateAspectPolicyStability` | exact birth, explicit profile, optional 3–10 points, and 2–4 named aspect policies | admission reasons, signed orb margins, set fingerprints, and deterministic equivalence groups |
 | `house_boundary_proximity` **beta** | `calculateHouseBoundaryProximity` | exact birth, explicit profile, optional 1–10 points and 0.1–10° threshold | exact two-sided cusp clearance, normalized position, nearest-boundary ties, and explicit no-fallback geometry failures |
+| `location_precision_audit` **beta** | `calculateLocationPrecisionAudit` | exact birth, one explicit 12-house system, 0.1–500 km radius, optional 1–10 points | nine sample rows, planet-house stability, maximum angle/cusp displacement, and explicit no-fallback geometry failures |
+| `location_transition_scan` **beta** | `calculateLocationTransitionScan` | exact birth, one explicit 12-house system, 1–500 km maximum radius, optional 1–10 points | 65 checkpoints and per-bearing first observed angle-sign, cusp-sign, and planet-house transition brackets or explicit failure states |
+| `chart_uncertainty_envelope` **beta** | `calculateChartUncertaintyEnvelope` | exact birth, one explicit 12-house system, 5–180 minute uncertainty, 0.1–500 km radius, optional 1–10 points | full-factorial 7-time × 9-location evidence separating time-axis, location-axis, combined, and interaction-only observed variation |
 | `synastry_svg` **beta** | `calculateSynastrySvg` | two births; optional zodiac/houses/theme/aspects/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `transit_svg` **beta** | `calculateTransitSvg` | birth and transit date; optional display controls/`include_png` | `result["svg"]`, optional `result["png"]` |
 | `natal_report` **beta** | `calculateNatalReport` | birth; optional zodiac/houses/theme/SVG/download | `result["html"]`, source-linked `result["facts"]`, optional `result["download"]` |

{astroapi_io_client-0.2.9 → astroapi_io_client-0.2.12}/tests/test_client.py

@@ -85,6 +85,9 @@ ROUTES += [
     ("house_placement_stability", "house-placement-stability", HOUSE_PLACEMENT_STABILITY_INPUT, {"type": "house_placement_stability", "status": "beta", "input": BIRTH, "profile": {}, "systems": [{} for _ in range(25)], "planets": [{} for _ in range(10)], "placement_groups": [], "summary": {}, "fallback": {"performed": False, "selected_system": None}, "metadata": {}}),
     ("aspect_policy_stability", "aspect-policy-stability", ASPECT_POLICY_STABILITY_INPUT, {"type": "aspect_policy_stability", "status": "beta", "input": {}, "positions": {}, "evaluations": [], "policy_results": [{}, {}], "policy_groups": [{}], "summary": {}, "metadata": {}}),
     ("house_boundary_proximity", "house-boundary-proximity", {"birth": BIRTH, "profile": {"zodiac": "tropical"}, "points": ["sun", "moon"], "threshold_degrees": 2.0}, {"type": "house_boundary_proximity", "status": "beta", "input": {}, "systems": [{} for _ in range(25)], "point_summaries": [{}, {}], "summary": {}, "fallback": {"performed": False, "selected_system": None}, "metadata": {}}),
+    ("location_precision_audit", "location-precision-audit", {"birth": BIRTH, "profile": {"zodiac": "tropical", "house_system": "placidus"}, "radius_km": 25.0, "points": ["sun", "moon"]}, {"type": "location_precision_audit", "status": "beta", "input": {}, "samples": [{} for _ in range(9)], "point_summaries": [{}, {}], "angle_summaries": {}, "cusp_summaries": [{} for _ in range(12)], "summary": {}, "fallback": {"performed": False, "selected_system": None}, "metadata": {}}),
+    ("location_transition_scan", "location-transition-scan", {"birth": BIRTH, "profile": {"zodiac": "tropical", "house_system": "placidus"}, "max_radius_km": 100.0, "points": ["sun", "moon"]}, {"type": "location_transition_scan", "status": "beta", "input": {}, "samples": [{} for _ in range(65)], "facts": [{} for _ in range(16)], "summary": {}, "fallback": {"performed": False, "selected_system": None}, "metadata": {}}),
+    ("chart_uncertainty_envelope", "chart-uncertainty-envelope", {"birth": BIRTH, "profile": {"zodiac": "tropical", "house_system": "placidus"}, "time_uncertainty_minutes": 30, "location_radius_km": 25.0, "points": ["sun", "moon"]}, {"type": "chart_uncertainty_envelope", "status": "beta", "input": {}, "time_samples": [{} for _ in range(7)], "location_samples": [{} for _ in range(9)], "samples": [{} for _ in range(63)], "facts": [{} for _ in range(18)], "summary": {}, "fallback": {"performed": False, "selected_system": None}, "metadata": {}}),
 ]
 
 @contextmanager
@@ -190,6 +193,9 @@ ROUTES += [
     ("house_placement_stability", "house-placement-stability", HOUSE_PLACEMENT_STABILITY_INPUT, {"type": "house_placement_stability", "status": "beta", "input": BIRTH, "profile": {}, "systems": [{} for _ in range(25)], "planets": [{} for _ in range(10)], "placement_groups": [], "summary": {}, "fallback": {"performed": False, "selected_system": None}, "metadata": {}}),
     ("aspect_policy_stability", "aspect-policy-stability", ASPECT_POLICY_STABILITY_INPUT, {"type": "aspect_policy_stability", "status": "beta", "input": {}, "positions": {}, "evaluations": [], "policy_results": [{}, {}], "policy_groups": [{}], "summary": {}, "metadata": {}}),
     ("house_boundary_proximity", "house-boundary-proximity", {"birth": BIRTH, "profile": {"zodiac": "tropical"}, "points": ["sun", "moon"], "threshold_degrees": 2.0}, {"type": "house_boundary_proximity", "status": "beta", "input": {}, "systems": [{} for _ in range(25)], "point_summaries": [{}, {}], "summary": {}, "fallback": {"performed": False, "selected_system": None}, "metadata": {}}),
+    ("location_precision_audit", "location-precision-audit", {"birth": BIRTH, "profile": {"zodiac": "tropical", "house_system": "placidus"}, "radius_km": 25.0, "points": ["sun", "moon"]}, {"type": "location_precision_audit", "status": "beta", "input": {}, "samples": [{} for _ in range(9)], "point_summaries": [{}, {}], "angle_summaries": {}, "cusp_summaries": [{} for _ in range(12)], "summary": {}, "fallback": {"performed": False, "selected_system": None}, "metadata": {}}),
+    ("location_transition_scan", "location-transition-scan", {"birth": BIRTH, "profile": {"zodiac": "tropical", "house_system": "placidus"}, "max_radius_km": 100.0, "points": ["sun", "moon"]}, {"type": "location_transition_scan", "status": "beta", "input": {}, "samples": [{} for _ in range(65)], "facts": [{} for _ in range(16)], "summary": {}, "fallback": {"performed": False, "selected_system": None}, "metadata": {}}),
+    ("chart_uncertainty_envelope", "chart-uncertainty-envelope", {"birth": BIRTH, "profile": {"zodiac": "tropical", "house_system": "placidus"}, "time_uncertainty_minutes": 30, "location_radius_km": 25.0, "points": ["sun", "moon"]}, {"type": "chart_uncertainty_envelope", "status": "beta", "input": {}, "time_samples": [{} for _ in range(7)], "location_samples": [{} for _ in range(9)], "samples": [{} for _ in range(63)], "facts": [{} for _ in range(18)], "summary": {}, "fallback": {"performed": False, "selected_system": None}, "metadata": {}}),
 ]
 
 @contextmanager
@@ -449,6 +455,18 @@ class ClientTests(unittest.TestCase):
                 client.civil_time_audit({**CIVIL_TIME_AUDIT_INPUT, "place_id": "geonames:5128581:2020-01-01"})
             with self.assertRaises(ValidationError):
                 client.chart_input_readiness({**CHART_INPUT_READINESS_INPUT, "birth_time": {"status": "approximate", "date": "2000-01-01", "time": "12:00"}})
+            with self.assertRaises(ValidationError):
+                client.location_precision_audit({"birth": BIRTH, "profile": {"zodiac": "tropical", "house_system": "placidus"}, "radius_km": 0})
+            with self.assertRaises(ValidationError):
+                client.location_precision_audit({"birth": BIRTH, "profile": {"zodiac": "tropical", "house_system": "gauquelin"}, "radius_km": 25})
+            with self.assertRaises(ValidationError):
+                client.location_transition_scan({"birth": BIRTH, "profile": {"zodiac": "tropical", "house_system": "placidus"}, "max_radius_km": 0})
+            with self.assertRaises(ValidationError):
+                client.location_transition_scan({"birth": BIRTH, "profile": {"zodiac": "tropical", "house_system": "gauquelin"}, "max_radius_km": 100})
+            with self.assertRaises(ValidationError):
+                client.chart_uncertainty_envelope({"birth": BIRTH, "profile": {"zodiac": "tropical", "house_system": "placidus"}, "time_uncertainty_minutes": 12, "location_radius_km": 25})
+            with self.assertRaises(ValidationError):
+                client.chart_uncertainty_envelope({"birth": BIRTH, "profile": {"zodiac": "tropical", "house_system": "placidus"}, "time_uncertainty_minutes": 30, "location_radius_km": 0})
 
 
     def test_request_body_limit(self):