ring-sandbox 0.1.0__tar.gz

ring_sandbox-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+.venv/
+__pycache__/
+*.pyc
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.ruff_cache/
+.env
+.env.*
+fixtures/me.json

ring_sandbox-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joseph Mayo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ring_sandbox-0.1.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.5
+Name: ring-sandbox
+Version: 0.1.0
+Summary: Typed Python client and offline emulator for the Ring Partner API (api.amazonvision.com)
+Project-URL: Homepage, https://github.com/josepha-mayo/ring-sandbox
+Project-URL: Documentation, https://developer.amazon.com/docs/ring/api-documentation.html
+Author: Joseph Mayo
+License-Expression: MIT
+License-File: LICENSE
+Keywords: amazon,amazonvision,emulator,ring,sandbox,webhooks
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Pytest
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.28
+Requires-Dist: pydantic>=2.7
+Provides-Extra: dev
+Requires-Dist: fastapi>=0.115; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: python-multipart>=0.0.9; extra == 'dev'
+Requires-Dist: pyyaml>=6.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: uvicorn>=0.30; extra == 'dev'
+Provides-Extra: server
+Requires-Dist: fastapi>=0.115; extra == 'server'
+Requires-Dist: python-multipart>=0.0.9; extra == 'server'
+Requires-Dist: pyyaml>=6.0; extra == 'server'
+Requires-Dist: uvicorn>=0.30; extra == 'server'
+Description-Content-Type: text/markdown
+
+# ring-sandbox
+
+Typed Python client **and** offline emulator for the [Ring Partner API](https://developer.amazon.com/docs/ring/api-documentation.html) (`api.amazonvision.com`).
+
+Ring ships no SDK and no local simulator. Testing a partner integration today means a real device, a 30-minute Playground token, or hand-rolled mocks. `ring-sandbox` gives you:
+
+- **`RingClient`** – a small, typed, synchronous client over `httpx` covering users, device discovery (with `?include=` side-loading), status, capabilities, configurations, location, event history (auto-pagination), image snapshots (303 redirect flow), media clips (200/206/416 semantics), and chime playback.
+- **Webhook helpers** – HMAC-SHA256 `X-Signature` signing/verification over raw bytes, v1.1 payload construction, and parsing into a `WebhookEvent`.
+- **Emulator** – a FastAPI app that speaks the same JSON:API shapes at `/v1/...`, plus a `/_sandbox` control plane to inject events, register webhook targets (the emulator signs and delivers them), add devices (doorbells, cameras, chimes, Early Access sensors), and reset.
+- **Scenarios** – scripted event sequences (`delivery`, `home_aide_visit`, `short_visit`, `no_show`, `device_flap`, or your own YAML), replayable in real time, time-compressed, or back-dated into history.
+- **pytest plugin** – `ring_client`, `ring_control`, `ring_world` fixtures that run the emulator in-process with no sockets.
+- **Recorder** – `ring-sandbox record --token ...` snapshots real Playground/production responses into JSON fixtures.
+
+## Install
+
+```bash
+pip install "ring-sandbox[server]"      # client + emulator + CLI
+pip install ring-sandbox                # client only
+
+# development: pinned, CI-tested dependency set
+pip install -r requirements-dev.txt -e ".[dev]"
+```
+
+## Client
+
+```python
+from ring_sandbox import RingClient
+
+with RingClient(token) as ring:                       # production by default
+    for d in ring.devices(include=["status", "capabilities"]):
+        print(d.name, d.online, d.capabilities.is_camera)
+
+    cam = next(d for d in ring.devices(include=["capabilities"]) if d.capabilities.is_camera)
+    for ev in ring.events(cam.id, event_types=["motion.human", "ding"]):
+        print(ev.attributes.started_at, ev.attributes.event_type)
+
+    snap = ring.snapshot_latest(cam.id, start=some_datetime)   # follows the 303 to the pre-signed URL
+    clip = ring.clip(cam.id, timestamp=some_datetime, duration_ms=10_000)
+    if clip.partial: print("only", clip.actual_length_ms, "ms available")
+```
+
+Media endpoints 303-redirect to a pre-signed URL on another host. Redirects are followed
+manually: bearer credentials and cookies are never forwarded, the response body is capped by
+`max_media_bytes`, and off-origin targets must be allowlisted — pass
+`media_origins=["https://media-host.example", "*.amazonaws.com"]` when talking to real Ring.
+JSON endpoints never follow redirects; device ids are treated as opaque single path segments.
+
+Point it at the emulator with `RingClient(token, base_url="http://127.0.0.1:8787")`.
+
+## Emulator
+
+```bash
+ring-sandbox serve --port 8787
+ring-sandbox webhook http://localhost:8000/webhooks/ring --key my-hmac-key
+ring-sandbox play delivery --speed 5           # courier: vehicle -> human -> ding -> package -> vehicle
+ring-sandbox play home_aide_visit --backdate   # 90-minute visit written straight into history
+ring-sandbox play examples/late_arrival.yml    # your own scenario: name, description, steps
+ring-sandbox inject --type motion_detected --sub-type human
+```
+
+Custom scenarios are plain YAML — `steps` entries take `offset_s`, `type`, optional `sub_type`, `device` (id or name), and `duration_ms`. See `examples/` for documented files: `late_arrival.yml` (aide shows 25 min late), `partial_blackout.yml` (camera dies mid-visit — departure unobserved), `visitor_not_worker.yml` (courier activity in the aide's window).
+
+Interactive docs at `http://127.0.0.1:8787/_sandbox/docs`. Drop real `default.jpg` / `default.mp4` (or `<device_id>.jpg`) in a folder and pass `--media-dir` to serve real media instead of placeholders.
+
+### Fidelity notes
+
+The emulator reproduces the parts of the API that bite integrators:
+
+| Behaviour | Emulated |
+|---|---|
+| JSON:API compound documents via `?include=` | yes |
+| History newest-first, `page[key]` cursor, dotted `event_types` filters | yes |
+| `is_third_party_reviewed` flips after media access | yes |
+| Snapshot `303 See Other` to a pre-signed URL | yes |
+| Clip `206 Partial` + `X-Media-Length`, `416 TIMESTAMP_NOT_FOUND` when idle | yes |
+| Chime playback restricted to the app's two audio slots | yes |
+| Sensor `faulted` semantics, `255` battery sentinel on mains devices | yes |
+| Webhook v1.1 payloads with `sub_type`, `component_ids`, HMAC `X-Signature` | yes |
+| OAuth / account linking / nonce flow | no (use any bearer token, or `--token` to pin one) |
+| WHEP / RTSP live video | no |
+
+## Webhooks
+
+```python
+from ring_sandbox import webhooks
+
+@app.post("/webhooks/ring")
+async def ring_hook(request: Request):
+    raw = await request.body()                                    # raw bytes, never re-serialized JSON
+    ev = webhooks.parse(raw, signing_key=KEY, signature=request.headers.get("X-Signature"))
+    if ev.event_type == "motion_detected" and ev.sub_type == "human": ...
+```
+
+## Chaos fault injection
+
+`ring-sandbox serve --chaos storm` runs the emulator with a fault-injection profile:
+webhook deliveries can be duplicated, dropped, or delayed with jitter, and history/media
+endpoints can return transient 500s. Presets: `delivery` (dup/drop/delay only), `flaky`
+(endpoint failures only), `storm` (both). A custom profile is a key=value list:
+`--chaos drop=0.2,duplicate=0.4,jitter_ms=1500`. `--chaos-seed N` makes the fault stream
+deterministic for reproducible runs.
+
+Every injected fault is recorded — `GET /_sandbox/chaos` returns the active profile plus
+the actions taken so far (`webhook.dropped`, `webhook.duplicated`, `webhook.delayed` with
+the applied ms). `POST /_sandbox/chaos` adjusts rates live (`{"drop": 0.5}`) without
+restarting. The point is proving the *receiver*: a correct consumer dedupes re-delivered
+`request_id`s, tolerates out-of-order arrival, and keeps working through flaky polls.
+
+## pytest
+
+```python
+def test_visit_detection(ring_client, ring_control):
+    ring_control.post("/_sandbox/events", json={"type": "motion_detected", "sub_type": "human"})
+    cam = ring_client.devices()[0]
+    assert next(ring_client.events(cam.id)).attributes.event_type == "motion"
+```
+
+## Status
+
+Built during the Amazon Developer Hackathon 2026. Response shapes follow the public documentation; where the docs are ambiguous the emulator follows what the Playground returns (see `fixtures/`). Sensors and chimes are Early Access upstream and may change.
+
+MIT licensed.

ring_sandbox-0.1.0/README.md

@@ -0,0 +1,122 @@
+# ring-sandbox
+
+Typed Python client **and** offline emulator for the [Ring Partner API](https://developer.amazon.com/docs/ring/api-documentation.html) (`api.amazonvision.com`).
+
+Ring ships no SDK and no local simulator. Testing a partner integration today means a real device, a 30-minute Playground token, or hand-rolled mocks. `ring-sandbox` gives you:
+
+- **`RingClient`** – a small, typed, synchronous client over `httpx` covering users, device discovery (with `?include=` side-loading), status, capabilities, configurations, location, event history (auto-pagination), image snapshots (303 redirect flow), media clips (200/206/416 semantics), and chime playback.
+- **Webhook helpers** – HMAC-SHA256 `X-Signature` signing/verification over raw bytes, v1.1 payload construction, and parsing into a `WebhookEvent`.
+- **Emulator** – a FastAPI app that speaks the same JSON:API shapes at `/v1/...`, plus a `/_sandbox` control plane to inject events, register webhook targets (the emulator signs and delivers them), add devices (doorbells, cameras, chimes, Early Access sensors), and reset.
+- **Scenarios** – scripted event sequences (`delivery`, `home_aide_visit`, `short_visit`, `no_show`, `device_flap`, or your own YAML), replayable in real time, time-compressed, or back-dated into history.
+- **pytest plugin** – `ring_client`, `ring_control`, `ring_world` fixtures that run the emulator in-process with no sockets.
+- **Recorder** – `ring-sandbox record --token ...` snapshots real Playground/production responses into JSON fixtures.
+
+## Install
+
+```bash
+pip install "ring-sandbox[server]"      # client + emulator + CLI
+pip install ring-sandbox                # client only
+
+# development: pinned, CI-tested dependency set
+pip install -r requirements-dev.txt -e ".[dev]"
+```
+
+## Client
+
+```python
+from ring_sandbox import RingClient
+
+with RingClient(token) as ring:                       # production by default
+    for d in ring.devices(include=["status", "capabilities"]):
+        print(d.name, d.online, d.capabilities.is_camera)
+
+    cam = next(d for d in ring.devices(include=["capabilities"]) if d.capabilities.is_camera)
+    for ev in ring.events(cam.id, event_types=["motion.human", "ding"]):
+        print(ev.attributes.started_at, ev.attributes.event_type)
+
+    snap = ring.snapshot_latest(cam.id, start=some_datetime)   # follows the 303 to the pre-signed URL
+    clip = ring.clip(cam.id, timestamp=some_datetime, duration_ms=10_000)
+    if clip.partial: print("only", clip.actual_length_ms, "ms available")
+```
+
+Media endpoints 303-redirect to a pre-signed URL on another host. Redirects are followed
+manually: bearer credentials and cookies are never forwarded, the response body is capped by
+`max_media_bytes`, and off-origin targets must be allowlisted — pass
+`media_origins=["https://media-host.example", "*.amazonaws.com"]` when talking to real Ring.
+JSON endpoints never follow redirects; device ids are treated as opaque single path segments.
+
+Point it at the emulator with `RingClient(token, base_url="http://127.0.0.1:8787")`.
+
+## Emulator
+
+```bash
+ring-sandbox serve --port 8787
+ring-sandbox webhook http://localhost:8000/webhooks/ring --key my-hmac-key
+ring-sandbox play delivery --speed 5           # courier: vehicle -> human -> ding -> package -> vehicle
+ring-sandbox play home_aide_visit --backdate   # 90-minute visit written straight into history
+ring-sandbox play examples/late_arrival.yml    # your own scenario: name, description, steps
+ring-sandbox inject --type motion_detected --sub-type human
+```
+
+Custom scenarios are plain YAML — `steps` entries take `offset_s`, `type`, optional `sub_type`, `device` (id or name), and `duration_ms`. See `examples/` for documented files: `late_arrival.yml` (aide shows 25 min late), `partial_blackout.yml` (camera dies mid-visit — departure unobserved), `visitor_not_worker.yml` (courier activity in the aide's window).
+
+Interactive docs at `http://127.0.0.1:8787/_sandbox/docs`. Drop real `default.jpg` / `default.mp4` (or `<device_id>.jpg`) in a folder and pass `--media-dir` to serve real media instead of placeholders.
+
+### Fidelity notes
+
+The emulator reproduces the parts of the API that bite integrators:
+
+| Behaviour | Emulated |
+|---|---|
+| JSON:API compound documents via `?include=` | yes |
+| History newest-first, `page[key]` cursor, dotted `event_types` filters | yes |
+| `is_third_party_reviewed` flips after media access | yes |
+| Snapshot `303 See Other` to a pre-signed URL | yes |
+| Clip `206 Partial` + `X-Media-Length`, `416 TIMESTAMP_NOT_FOUND` when idle | yes |
+| Chime playback restricted to the app's two audio slots | yes |
+| Sensor `faulted` semantics, `255` battery sentinel on mains devices | yes |
+| Webhook v1.1 payloads with `sub_type`, `component_ids`, HMAC `X-Signature` | yes |
+| OAuth / account linking / nonce flow | no (use any bearer token, or `--token` to pin one) |
+| WHEP / RTSP live video | no |
+
+## Webhooks
+
+```python
+from ring_sandbox import webhooks
+
+@app.post("/webhooks/ring")
+async def ring_hook(request: Request):
+    raw = await request.body()                                    # raw bytes, never re-serialized JSON
+    ev = webhooks.parse(raw, signing_key=KEY, signature=request.headers.get("X-Signature"))
+    if ev.event_type == "motion_detected" and ev.sub_type == "human": ...
+```
+
+## Chaos fault injection
+
+`ring-sandbox serve --chaos storm` runs the emulator with a fault-injection profile:
+webhook deliveries can be duplicated, dropped, or delayed with jitter, and history/media
+endpoints can return transient 500s. Presets: `delivery` (dup/drop/delay only), `flaky`
+(endpoint failures only), `storm` (both). A custom profile is a key=value list:
+`--chaos drop=0.2,duplicate=0.4,jitter_ms=1500`. `--chaos-seed N` makes the fault stream
+deterministic for reproducible runs.
+
+Every injected fault is recorded — `GET /_sandbox/chaos` returns the active profile plus
+the actions taken so far (`webhook.dropped`, `webhook.duplicated`, `webhook.delayed` with
+the applied ms). `POST /_sandbox/chaos` adjusts rates live (`{"drop": 0.5}`) without
+restarting. The point is proving the *receiver*: a correct consumer dedupes re-delivered
+`request_id`s, tolerates out-of-order arrival, and keeps working through flaky polls.
+
+## pytest
+
+```python
+def test_visit_detection(ring_client, ring_control):
+    ring_control.post("/_sandbox/events", json={"type": "motion_detected", "sub_type": "human"})
+    cam = ring_client.devices()[0]
+    assert next(ring_client.events(cam.id)).attributes.event_type == "motion"
+```
+
+## Status
+
+Built during the Amazon Developer Hackathon 2026. Response shapes follow the public documentation; where the docs are ambiguous the emulator follows what the Playground returns (see `fixtures/`). Sensors and chimes are Early Access upstream and may change.
+
+MIT licensed.

ring_sandbox-0.1.0/examples/late_arrival.yml

@@ -0,0 +1,36 @@
+# Custom scenario for `ring-sandbox play` / `attest replay`.
+#
+# A home-health aide is scheduled for 09:00 but the first observation is at
+# 09:25 — useful for exercising divergence reporting and worker reviews.
+# Field reference (see ring_sandbox.scenarios.Step):
+#   offset_s    seconds after the scenario's simulated start
+#   type        webhook event type: motion_detected | button_press |
+#               contact_sensor_faulted | contact_sensor_cleared |
+#               device_offline | device_online
+#   sub_type    motion hint: human | vehicle | package (optional)
+#   device      device id or name; omit for the default doorbell (optional)
+#   duration_ms event duration in milliseconds (optional)
+
+name: late_arrival
+description: Scheduled at window start; nobody observed until 25 minutes in.
+steps:
+  - offset_s: 1500   # 25 min in
+    type: motion_detected
+    sub_type: human
+  - offset_s: 1510
+    type: button_press
+  - offset_s: 1530
+    type: contact_sensor_faulted
+    device: Front Door Sensor
+  - offset_s: 1550
+    type: contact_sensor_cleared
+    device: Front Door Sensor
+  - offset_s: 4800   # ~80-min visit, departs
+    type: contact_sensor_faulted
+    device: Front Door Sensor
+  - offset_s: 4815
+    type: contact_sensor_cleared
+    device: Front Door Sensor
+  - offset_s: 4820
+    type: motion_detected
+    sub_type: human

ring_sandbox-0.1.0/examples/partial_blackout.yml

@@ -0,0 +1,32 @@
+# Custom scenario for `ring-sandbox play` / `attest replay`.
+#
+# The aide arrives on time, but the doorbell drops offline 20 minutes in and
+# stays down past the window — the departure is never observed. Useful for
+# exercising honest "departure unconfirmed" records and coverage gaps.
+# Field reference (see ring_sandbox.scenarios.Step):
+#   offset_s    seconds after the scenario's simulated start
+#   type        webhook event type: motion_detected | button_press |
+#               contact_sensor_faulted | contact_sensor_cleared |
+#               device_offline | device_online
+#   sub_type    motion hint: human | vehicle | package (optional)
+#   device      device id or name; omit for the default doorbell (optional)
+#   duration_ms event duration in milliseconds (optional)
+
+name: partial_blackout
+description: On-time arrival, then the camera dies mid-visit — departure unobserved.
+steps:
+  - offset_s: 0
+    type: motion_detected
+    sub_type: human
+  - offset_s: 6
+    type: button_press
+  - offset_s: 20
+    type: contact_sensor_faulted
+    device: Front Door Sensor
+  - offset_s: 35
+    type: contact_sensor_cleared
+    device: Front Door Sensor
+  - offset_s: 1200    # 20 min in — the doorbell drops offline
+    type: device_offline
+  - offset_s: 7200    # two hours later it recovers, after the window closed
+    type: device_online

ring_sandbox-0.1.0/examples/visitor_not_worker.yml

@@ -0,0 +1,31 @@
+# Custom scenario for `ring-sandbox play` / `attest replay`.
+#
+# Doorstep activity during the aide's scheduled window — but it's a courier:
+# package motion, a quick doorbell press, no door cycle. The record should show
+# observed activity without implying the scheduled worker arrived.
+# Field reference (see ring_sandbox.scenarios.Step):
+#   offset_s    seconds after the scenario's simulated start
+#   type        webhook event type: motion_detected | button_press |
+#               contact_sensor_faulted | contact_sensor_cleared |
+#               device_offline | device_online
+#   sub_type    motion hint: human | vehicle | package (optional)
+#   device      device id or name; omit for the default doorbell (optional)
+#   duration_ms event duration in milliseconds (optional)
+
+name: visitor_not_worker
+description: Courier activity in the aide's window — observed, but not the scheduled worker.
+steps:
+  - offset_s: 600     # 10 min into the window a vehicle pulls up
+    type: motion_detected
+    sub_type: vehicle
+  - offset_s: 620
+    type: motion_detected
+    sub_type: human
+  - offset_s: 630
+    type: button_press
+  - offset_s: 640
+    type: motion_detected
+    sub_type: package
+  - offset_s: 660
+    type: motion_detected
+    sub_type: vehicle

ring_sandbox-0.1.0/fixtures/README.md

@@ -0,0 +1 @@
+Real responses recorded from api.amazonvision.com with a Playground token via `ring-sandbox record` on 2026-09-15. Device ids are the Playground's synthetic Doorbell Pro. `me.json` is not committed.

ring_sandbox-0.1.0/fixtures/devices.json

@@ -0,0 +1,181 @@
+{
+  "data": [
+    {
+      "type": "devices",
+      "id": "ava1.ring.device.DCT27DEDP2FDDRTDVIE62YYMBEDQN3NX5BIT44JHC2J6KXZG3J4NZE7LXTU67NPGY7NJ6I3AWQS3532PMPUZ3QCFJDXNDR6O",
+      "attributes": {
+        "image_url": "https://app-content.ring.com/shared/images/devices/square_device_images/DoorbellPro/rvdp_3x.png",
+        "name": "Playground Device"
+      },
+      "relationships": {
+        "status": {
+          "data": {
+            "type": "device-status",
+            "id": "ava1.ring.device.status.Z5SWOVK22ZKGIZKCL5YW2OUB7F2ETAFR3P4GHTGYQWR5AFQYDLRIBCUTVXQIJSFDBI52BU3BQYL6SLQRX4P7RRIAN3MKIDLQ"
+          },
+          "links": {
+            "related": "/v1/devices/ava1.ring.device.DCT27DEDP2FDDRTDVIE62YYMBEDQN3NX5BIT44JHC2J6KXZG3J4NZE7LXTU67NPGY7NJ6I3AWQS3532PMPUZ3QCFJDXNDR6O/status"
+          }
+        },
+        "location": {
+          "data": {
+            "type": "locations",
+            "id": "ava1.ring.location.NWMCX4YY3NA25FEBNT2AYFEECHDPUBMR4DGXTMDPOGVGD2YLTIIH5FQ5TJYHQP3Q7HOQQT3ZXBVN4XGUAKEXOOHCM37KE7I64AA57ELYP5D5XDQA7C5E3IP3CA"
+          },
+          "links": {
+            "related": "/v1/devices/ava1.ring.device.DCT27DEDP2FDDRTDVIE62YYMBEDQN3NX5BIT44JHC2J6KXZG3J4NZE7LXTU67NPGY7NJ6I3AWQS3532PMPUZ3QCFJDXNDR6O/location"
+          }
+        },
+        "capabilities": {
+          "data": {
+            "type": "device-capabilities",
+            "id": "ava1.ring.device.capabilities.7PI6SEHHABUDBWLTRS57HDZF3C63I4ME52HJSU6MIKXTQCOQ53GYOJ6PVJV6H7D6RADKFULI5BY3CC4II6YT3K7WW2GJIRUU"
+          },
+          "links": {
+            "related": "/v1/devices/ava1.ring.device.DCT27DEDP2FDDRTDVIE62YYMBEDQN3NX5BIT44JHC2J6KXZG3J4NZE7LXTU67NPGY7NJ6I3AWQS3532PMPUZ3QCFJDXNDR6O/capabilities"
+          }
+        },
+        "configurations": {
+          "data": {
+            "type": "device-configurations",
+            "id": "ava1.ring.device.configurations.WIEQVPAOOPWTGREOVHSMBTMTNVZWYEEBST6L6WALDEVA3J3M5B76TL4MH227OT47326BK3WJASCCIWFX3RTSHMFJ7H3I52Y4ZQYXRVXADUL4PTT6NYF2H7DXHU"
+          },
+          "links": {
+            "related": "/v1/devices/ava1.ring.device.DCT27DEDP2FDDRTDVIE62YYMBEDQN3NX5BIT44JHC2J6KXZG3J4NZE7LXTU67NPGY7NJ6I3AWQS3532PMPUZ3QCFJDXNDR6O/configurations"
+          }
+        }
+      }
+    }
+  ],
+  "included": [
+    {
+      "type": "locations",
+      "id": "ava1.ring.location.NWMCX4YY3NA25FEBNT2AYFEECHDPUBMR4DGXTMDPOGVGD2YLTIIH5FQ5TJYHQP3Q7HOQQT3ZXBVN4XGUAKEXOOHCM37KE7I64AA57ELYP5D5XDQA7C5E3IP3CA",
+      "attributes": {
+        "state": "CA",
+        "country": "US"
+      }
+    },
+    {
+      "type": "device-status",
+      "id": "ava1.ring.device.status.Z5SWOVK22ZKGIZKCL5YW2OUB7F2ETAFR3P4GHTGYQWR5AFQYDLRIBCUTVXQIJSFDBI52BU3BQYL6SLQRX4P7RRIAN3MKIDLQ",
+      "attributes": {
+        "audio": {
+          "snooze": {
+            "active": null,
+            "until": null
+          }
+        },
+        "online": true,
+        "reported_at": "2026-09-15T12:45:03Z",
+        "state": null
+      }
+    },
+    {
+      "type": "device-capabilities",
+      "id": "ava1.ring.device.capabilities.7PI6SEHHABUDBWLTRS57HDZF3C63I4ME52HJSU6MIKXTQCOQ53GYOJ6PVJV6H7D6RADKFULI5BY3CC4II6YT3K7WW2GJIRUU",
+      "attributes": {
+        "video": {
+          "configurations": [
+            "resolution_mode"
+          ],
+          "codecs": [
+            "AVC"
+          ],
+          "ratio": "16:9",
+          "max_resolution": 1080,
+          "supported_resolutions": [
+            1080
+          ]
+        },
+        "audio": {
+          "customizable_slots": null,
+          "supported_actions": null
+        },
+        "image_enhancements": {
+          "configurations": [
+            "color_night_vision",
+            "privacy_zones",
+            "snapshot"
+          ]
+        },
+        "flood_detection": null,
+        "tamper_detection": null,
+        "glass_break_detection": null,
+        "motion_detection": {
+          "configurations": [
+            "enabled",
+            "motion_zones"
+          ]
+        },
+        "smoke_detection": null,
+        "freeze_detection": null,
+        "co_detection_listener": null,
+        "battery_status": null,
+        "contact_detection": null
+      }
+    },
+    {
+      "type": "device-configurations",
+      "id": "ava1.ring.device.configurations.WIEQVPAOOPWTGREOVHSMBTMTNVZWYEEBST6L6WALDEVA3J3M5B76TL4MH227OT47326BK3WJASCCIWFX3RTSHMFJ7H3I52Y4ZQYXRVXADUL4PTT6NYF2H7DXHU",
+      "attributes": {
+        "motion_detection": {
+          "enabled": "on",
+          "motion_zones": [
+            {
+              "id": "bac09fbb-7a79-4eca-80d8-4e05a4ea8d07",
+              "vertices": [
+                {
+                  "x": 0,
+                  "y": 0
+                },
+                {
+                  "x": 0.5,
+                  "y": 0
+                },
+                {
+                  "x": 1,
+                  "y": 0
+                },
+                {
+                  "x": 1,
+                  "y": 0.6
+                },
+                {
+                  "x": 1,
+                  "y": 1
+                },
+                {
+                  "x": 0.5,
+                  "y": 1
+                },
+                {
+                  "x": 0,
+                  "y": 1
+                },
+                {
+                  "x": 0,
+                  "y": 0.6
+                }
+              ]
+            }
+          ]
+        },
+        "audio": {
+          "customizable_slots": null,
+          "volume": 11
+        },
+        "image_enhancements": {
+          "color_night_vision": "off",
+          "hdr": "off",
+          "ir_led_night_vision": "off",
+          "auto_zoom_track": "off",
+          "privacy_zones": []
+        }
+      }
+    }
+  ],
+  "meta": {
+    "time": "2026-09-15T12:47:12Z"
+  }
+}