# API Reference

This section documents the public Python surface area of **dxaws-cloudfront**.

The API is intentionally small:

- **Models**: stable contract for desired/current/plan/result
- **Manager**: orchestration entry point (`execute`, `destroy`)
- **Providers**: AWS implementation + provider protocol

---

## Contents

```{toctree}
:maxdepth: 2
:caption: API

api/modules
```

---

## Key entry points

- `dxaws_cloudfront.manager.CloudFrontManager`
- `dxaws_cloudfront.models.DistributionDesired`
- `dxaws_cloudfront.models.DistributionResult`
- `dxaws_cloudfront.providers.aws.AwsProvider`

Notes:

- Destroy is modeled as convergence to `DistributionDesired(present=False)`.
- CloudFront requires ACM certificates in `us-east-1` when using aliases.
```