<?php

namespace App\Http\Resources;

use App\Models\Device;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;

/**
 * @mixin Device
 *
 * `devices.status` in Postgres is only a stale snapshot (see migration
 * comment) — Redis (Device Shadow) is authoritative. The controller stamps
 * the live value onto the model as `live_status` before wrapping it here;
 * `status` in the JSON always prefers that when present.
 */
class DeviceResource extends JsonResource
{
    /** @return array<string, mixed> */
    public function toArray(Request $request): array
    {
        return [
            'id' => $this->id,
            'name' => $this->name,
            'external_id' => $this->external_id,
            'protocol' => $this->protocol,
            'status' => $this->live_status ?? $this->status,
            // Nested resources are resolved (not returned as bare Resource
            // instances) — a Resource embedded as a value gets wrapped in its
            // own `data` key when the parent response goes through Laravel's
            // Responsable pipeline (Inertia props, ->response() in the API),
            // which would double up with the outer collection's own wrapping.
            'zone' => $this->whenLoaded('zone', fn ($zone) => (new ZoneResource($zone))->resolve()),
            'device_type' => $this->whenLoaded('deviceType', fn ($type) => (new DeviceTypeResource($type))->resolve()),
            'created_at' => $this->created_at,
        ];
    }
}