feat: Support direct access token auth, auto device discovery, and du…

.env.example

@@ -1,13 +1,27 @@
-# Ring Camera OAuth credentials
-RING_REFRESH_TOKEN=your_refresh_token_here
-RING_CLIENT_ID=test-ava-partner-prod
-RING_CLIENT_SECRET=your_client_secret_here
-
-# Ring Device
-NEXT_PUBLIC_RING_DEVICE_ID=your_device_id_here
-NEXT_PUBLIC_RING_DEVICE_NAME=Camera
-
-# Ring Webhook Authentication
-# Ring sends OAuth 2.0 Bearer token with webhook requests
-# Set this to the partner access token Ring will use for authentication
-RING_WEBHOOK_SECRET=your_partner_access_token_here
+# =============================================================================
+# Authentication (choose ONE of the two options below)
+# =============================================================================
+
+# Option 1: Access Token (simplest — get from Ring Developer Playground)
+# Get your token at: https://developer.amazon.com/ring/console/playground
+# RING_ACCESS_TOKEN=your_access_token_here
+
+# Option 2: Refresh Token (auto-renewing — for production integrations)
+# Get credentials by registering your app: https://developer.amazon.com/docs/ring/app-registration.html
+# Get refresh token via OAuth account linking: https://developer.amazon.com/docs/ring/authentication.html
+# RING_REFRESH_TOKEN=your_refresh_token_here
+# RING_CLIENT_ID=your_client_id_here
+# RING_CLIENT_SECRET=your_client_secret_here
+
+# =============================================================================
+# Device (optional — auto-discovered if not set)
+# =============================================================================
+# Device IDs are returned by the /v1/devices API. Run: python scripts/list_devices.py --token "..."
+# NEXT_PUBLIC_RING_DEVICE_ID=your_device_id_here
+# NEXT_PUBLIC_RING_DEVICE_NAME=Camera
+
+# =============================================================================
+# Webhook (optional — for refresh token mode only)
+# =============================================================================
+# See: https://developer.amazon.com/docs/ring/notifications.html
+# RING_WEBHOOK_SECRET=your_partner_access_token_here