astroapi 1.0.1

A comprehensive Dart SDK for the Astrology API v3 — horoscopes, natal charts, planetary positions, and more

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

1.0.1 - 2026-02-20

Changed

• Expanded CLAUDE.md with a detailed layer-by-layer architecture reference and SDK extension guide for AI assistants.
• Added release process documentation (version bump steps, git tag workflow, semver rules) to CLAUDE.md and README.md.

1.0.0 - 2026-02-20

Added

• AstrologyClient with 16 category sub-clients: data, charts, horoscope, analysis, glossary, astrocartography, chinese, eclipses, lunar, numerology, tarot, traditional, fixedStars, insights, svg, and enhanced.
• InsightsClient with 5 typed sub-clients: relationship, pet, wellness, financial, and business.
• AstrologyClientConfig with configurable API key, base URL, timeout, debug mode, and custom logger.
• RetryConfig for automatic retry on transient errors with configurable attempt count, delay, and retry status codes.
• RequestOptions for per-request headers, query parameters, timeout override, and Dio CancelToken support.
• AstrologyException with HTTP status code, error code, and detail fields.
• HttpHelper abstract interface for mock-based unit testing.
• Dio-based DioHttpClient with Bearer token injection, automatic response unwrapping, and retry logic.
• SVG chart support via SvgClient returning raw String.
• GenericResponse for complex or schema-variable API responses.
• Request and response model classes for all 16 API categories.
• Enum types: Language, HouseSystem, ZodiacType, Tradition, PerspectiveType, DetailLevel.