docs: add async client, healthchecks, pagination to README and CHANGELOG; bump to v1.1.0

Author: KhaledSalhab-Develeap

CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.0] - 2026-04-09
+
+### Added
+
+- **`AsyncHyperpingClient`** — full async counterpart to `HyperpingClient`. All resources
+  (monitors, incidents, maintenance, outages, status pages, healthchecks) are available via
+  `await`. Retry logic uses `asyncio.sleep`; circuit breaker and `RetryConfig` are shared with
+  the sync client. Exported from `hyperping` top-level.
+- **`HealthchecksMixin`** — full CRUD for push-based cron/heartbeat monitoring:
+  `list_healthchecks`, `get_healthcheck`, `create_healthcheck`, `update_healthcheck`,
+  `delete_healthcheck`, `pause_healthcheck`, `resume_healthcheck`. `Healthcheck`,
+  `HealthcheckCreate`, `HealthcheckUpdate` models exported from `hyperping`.
+- **Pagination** on `list_outages`, `list_status_pages`, `list_subscribers`. Pass
+  `page=None` (default) to auto-fetch all pages via `hasNextPage`; pass an explicit
+  `int` to retrieve a single page. `status` and `outage_type` filter params added to
+  `list_outages`.
+- **Typed `OutageAction`** return type for `acknowledge_outage`, `resolve_outage`,
+  `escalate_outage`, `unacknowledge_outage` (was `dict[str, Any]`).
+- **`_internals.py`** — shared `RETRY_AFTER_MAX`, `DEFAULT_USER_AGENT`, `sanitize_for_log`
+  used by both sync and async clients (eliminates private cross-module imports).
+- **`_monitor_constants.py`** — shared `VALID_PERIODS`, `MONITOR_WRITABLE_FIELDS`
+  constants used by both sync and async monitor mixins.
+- **`collect_all_pages` / `collect_all_pages_async`** helpers in `_utils.py` for
+  transparent multi-page result aggregation.
+
 ## [1.0.0] - 2026-04-05
 
 First stable release. The public API is production-ready and covered by semver

README.md

@@ -43,6 +43,24 @@ with HyperpingClient(api_key="sk_...") as client:
     client.resolve_incident(incident.uuid, "All systems operational")
 ```
 
+## Async Client
+
+An async-first client is available for use with `asyncio` and `anyio`-based frameworks:
+
+```python
+from hyperping import AsyncHyperpingClient
+
+async def main():
+    async with AsyncHyperpingClient(api_key="sk_...") as client:
+        monitors = await client.list_monitors()
+        for m in monitors:
+            print(f"{m.name}: {'down' if m.down else 'up'}")
+
+        outage = await client.acknowledge_outage("out_uuid", message="On it")
+```
+
+The async client supports all the same resources, retry behaviour, and circuit breaker as the sync client. Use `RetryConfig` and `CircuitBreakerConfig` in exactly the same way.
+
 ## Authentication
 
 Pass your API key directly or via environment variable:
@@ -103,7 +121,8 @@ in_maint = client.is_monitor_in_maintenance("mon_uuid")
 ### Outages
 
 ```python
-outages = client.list_outages()
+outages = client.list_outages()              # auto-fetches all pages
+outages = client.list_outages(page=0)        # single page
 client.acknowledge_outage("out_uuid", message="On it")
 client.resolve_outage("out_uuid", message="Fixed")
 client.escalate_outage("out_uuid")
@@ -112,18 +131,31 @@ client.escalate_outage("out_uuid")
 ### Status Pages
 
 ```python
-pages = client.list_status_pages(search="prod")
+pages = client.list_status_pages(search="prod")    # auto-fetches all pages
+pages = client.list_status_pages(page=0)            # single page
 page  = client.get_status_page("sp_uuid")
 created = client.create_status_page(StatusPageCreate(name="Prod", subdomain="prod-status"))
 client.update_status_page("sp_uuid", StatusPageUpdate(name="Production Status"))
 client.delete_status_page("sp_uuid")
 
 # Subscribers
-subs = client.list_subscribers("sp_uuid")
+subs = client.list_subscribers("sp_uuid")           # auto-fetches all pages
 sub  = client.add_subscriber("sp_uuid", "user@example.com")
 client.remove_subscriber("sp_uuid", sub.id)
 ```
 
+### Healthchecks
+
+```python
+checks = client.list_healthchecks()
+check  = client.get_healthcheck("hc_uuid")
+created = client.create_healthcheck(HealthcheckCreate(name="Nightly Job", period=86400, grace=3600))
+client.update_healthcheck("hc_uuid", HealthcheckUpdate(grace=7200))
+client.pause_healthcheck("hc_uuid")
+client.resume_healthcheck("hc_uuid")
+client.delete_healthcheck("hc_uuid")
+```
+
 ## Error Handling
 
 ```python

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hyperping"
-version = "1.0.1"
+version = "1.1.0"
 description = "Python SDK for the Hyperping uptime monitoring and incident management API"
 readme = {file = "README.md", content-type = "text/markdown"}
 license = {text = "MIT"}