@fleetbase/fleetops-engine 0.6.51 → 0.6.53

package/server/src/Support/Telematics/Providers/SafeeProvider.php

@@ -13,13 +13,13 @@ use Illuminate\Support\Facades\Http;
  */
 class SafeeProvider extends AbstractProvider
 {
-    protected string $baseUrl        = '';
+    protected string $baseUrl        = 'https://api.safee.com';
     protected int $requestsPerMinute = 3000;
     protected ?string $accessToken   = null;
 
     protected function prepareAuthentication(): void
     {
-        $this->baseUrl     = rtrim($this->credentials['api_base_url'] ?? $this->credentials['server_uri'] ?? '', '/');
+        $this->baseUrl     = rtrim($this->credentials['api_base_url'] ?? $this->credentials['server_uri'] ?? $this->baseUrl, '/');
         $this->accessToken = $this->credentials['access_token'] ?? $this->authenticate();
         $scheme            = $this->credentials['authorization_scheme'] ?? 'Bearer';
 
@@ -90,17 +90,21 @@ class SafeeProvider extends AbstractProvider
 
     public function normalizeDevice(array $payload): array
     {
-        $position = $this->extractPosition($payload);
+        $position  = $this->extractPosition($payload);
+        $rawStatus = $payload['status'] ?? $payload['vehicleStatus'] ?? null;
+        $status    = $this->normalizeVehicleStatus($rawStatus);
 
         return [
-            'external_id'     => $payload['id'] ?? data_get($payload, 'vehicle.id') ?? null,
-            'device_name'     => $payload['name'] ?? $payload['plateNumber'] ?? data_get($payload, 'vehicle.name') ?? 'Unknown Vehicle',
-            'device_provider' => 'safee',
-            'device_model'    => $payload['model'] ?? data_get($payload, 'device.model') ?? null,
-            'imei'            => data_get($payload, 'device.imei') ?? data_get($payload, 'device.serial') ?? null,
-            'vin'             => $payload['vin'] ?? null,
-            'status'          => $this->normalizeVehicleStatus($payload['status'] ?? $payload['vehicleStatus'] ?? null),
-            'location'        => [
+            'device_id'    => $payload['id'] ?? data_get($payload, 'vehicle.id') ?? null,
+            'name'         => $payload['name'] ?? $payload['plateNumber'] ?? data_get($payload, 'vehicle.name') ?? 'Unknown Vehicle',
+            'provider'     => 'safee',
+            'model'        => $payload['model'] ?? data_get($payload, 'device.model') ?? null,
+            'imei'         => data_get($payload, 'device.imei') ?? data_get($payload, 'device.serial') ?? null,
+            'vin'          => $payload['vin'] ?? null,
+            'status'       => $status,
+            'online'       => $rawStatus ? $status === 'active' : null,
+            'last_seen_at' => $this->parseTimestamp($payload['date'] ?? $payload['deviceTime'] ?? $payload['time'] ?? null),
+            'location'     => [
                 'lat' => $position['lat'] ?? null,
                 'lng' => $position['lng'] ?? null,
             ],
@@ -126,7 +130,9 @@ class SafeeProvider extends AbstractProvider
 
         return [
             'external_id' => $payload['id'] ?? data_get($payload, 'vehicle.id') ?? null,
+            'device_id'   => $payload['id'] ?? data_get($payload, 'vehicle.id') ?? null,
             'event_type'  => data_get($payload, 'event.code') ?? data_get($payload, 'event.name') ?? 'telemetry_update',
+            'message'     => data_get($payload, 'event.name') ?? data_get($payload, 'event.message') ?? null,
             'occurred_at' => $this->parseTimestamp($payload['date'] ?? $payload['deviceTime'] ?? $payload['time'] ?? null),
             'location'    => [
                 'lat' => $position['lat'] ?? null,
@@ -156,12 +162,16 @@ class SafeeProvider extends AbstractProvider
     {
         return [
             [
-                'name'        => 'server_uri',
-                'label'       => 'Server URI',
-                'type'        => 'text',
-                'placeholder' => 'https://tracking.example.com',
-                'required'    => true,
-                'validation'  => 'required|url',
+                'name'          => 'server_uri',
+                'label'         => 'Server URI',
+                'type'          => 'text',
+                'placeholder'   => 'https://api.safee.com',
+                'required'      => false,
+                'advanced'      => true,
+                'is_endpoint'   => true,
+                'default_value' => 'https://api.safee.com',
+                'help_text'     => 'Optional override. Leave blank to use the default Safee API host.',
+                'validation'    => 'nullable|url',
             ],
             [
                 'name'        => 'realm_id',
@@ -203,13 +213,13 @@ class SafeeProvider extends AbstractProvider
 
     protected function authenticate(): string
     {
-        foreach (['server_uri', 'realm_id', 'client_id', 'client_secret', 'username', 'password'] as $field) {
+        foreach (['realm_id', 'client_id', 'client_secret', 'username', 'password'] as $field) {
             if (empty($this->credentials[$field])) {
                 throw new \InvalidArgumentException("Safee credential '{$field}' is required.");
             }
         }
 
-        $tokenUrl = rtrim($this->credentials['server_uri'], '/') . '/auth/realms/' . $this->credentials['realm_id'] . '/protocol/openid-connect/token';
+        $tokenUrl = $this->baseUrl . '/auth/realms/' . $this->credentials['realm_id'] . '/protocol/openid-connect/token';
 
         $response = Http::asForm()
             ->acceptJson()
@@ -223,7 +233,7 @@ class SafeeProvider extends AbstractProvider
             ]);
 
         if ($response->failed()) {
-            throw new \RuntimeException('Safee authentication failed: ' . $response->body());
+            throw new \RuntimeException('Safee authentication failed with status ' . $response->status());
         }
 
         $token = $response->json('access_token');
@@ -242,7 +252,7 @@ class SafeeProvider extends AbstractProvider
             ->get($this->baseUrl . $endpoint);
 
         if ($response->failed()) {
-            throw new \RuntimeException('Safee API request failed: ' . $response->body());
+            throw new \RuntimeException('Safee API request failed with status ' . $response->status());
         }
 
         return $response->json() ?? [];
@@ -255,7 +265,7 @@ class SafeeProvider extends AbstractProvider
             ->post($this->baseUrl . $endpoint, $payload);
 
         if ($response->failed()) {
-            throw new \RuntimeException('Safee API request failed: ' . $response->body());
+            throw new \RuntimeException('Safee API request failed with status ' . $response->status());
         }
 
         return $response->json() ?? [];

package/server/src/Support/Telematics/Providers/SamsaraProvider.php

@@ -94,6 +94,7 @@ class SamsaraProvider extends AbstractProvider
     {
         return [
             'external_id' => $payload['id'] ?? null,
+            'device_id'   => $payload['vehicle']['id'] ?? $payload['vehicleId'] ?? null,
             'event_type'  => $payload['eventType'] ?? 'vehicle_update',
             'occurred_at' => $payload['time'] ?? now(),
             'location'    => [
@@ -135,7 +136,8 @@ class SamsaraProvider extends AbstractProvider
         if (isset($payload['data'])) {
             foreach ($payload['data'] as $item) {
                 if (isset($item['vehicle'])) {
-                    $devices[] = $this->normalizeDevice($item['vehicle']);
+                    $devices[]         = $this->normalizeDevice($item['vehicle']);
+                    $item['vehicleId'] = $item['vehicle']['id'] ?? null;
                 }
 
                 $events[] = $this->normalizeEvent($item);

package/server/src/Support/Telematics/TelematicService.php

@@ -2,12 +2,15 @@
 
 namespace Fleetbase\FleetOps\Support\Telematics;
 
-use Fleetbase\FleetOps\Jobs\SyncDevicesJob;
-use Fleetbase\FleetOps\Jobs\TestConnectionJob;
+use Fleetbase\FleetOps\Jobs\SyncTelematicDevicesJob;
+use Fleetbase\FleetOps\Jobs\TestTelematicConnectionJob;
 use Fleetbase\FleetOps\Models\Device;
+use Fleetbase\FleetOps\Models\DeviceEvent;
+use Fleetbase\FleetOps\Models\Sensor;
 use Fleetbase\FleetOps\Models\Telematic;
 use Illuminate\Support\Facades\Crypt;
 use Illuminate\Support\Facades\Validator;
+use Illuminate\Support\Str;
 use Illuminate\Validation\ValidationException;
 
 /**
@@ -58,7 +61,7 @@ class TelematicService
         $telematic->company_uuid = session('company');
         $telematic->name         = $data['name'];
         $telematic->provider     = $providerKey;
-        $telematic->credentials  = Crypt::encryptString(json_encode($data['credentials']));
+        $telematic->credentials  = $this->encryptCredentials($data['credentials']);
         $telematic->status       = 'active';
         $telematic->meta         = $data['meta'] ?? [];
         $telematic->save();
@@ -78,7 +81,7 @@ class TelematicService
         if (isset($data['credentials'])) {
             $descriptor = $this->registry->findByKey($telematic->provider);
             $this->validateCredentials($data['credentials'], $descriptor->requiredFields);
-            $telematic->credentials = Crypt::encryptString(json_encode($data['credentials']));
+            $telematic->credentials = $this->encryptCredentials($data['credentials']);
         }
 
         if (isset($data['status'])) {
@@ -110,18 +113,21 @@ class TelematicService
     public function testConnection(Telematic $telematic, bool $async = false)
     {
         if ($async) {
-            $job = new TestConnectionJob($telematic);
-            dispatch($job);
+            $jobId = (string) Str::uuid();
+            dispatch(new TestTelematicConnectionJob($telematic, $jobId));
 
-            return ['job_id' => $job->getJobId(), 'message' => 'Connection test queued'];
+            return ['job_id' => $jobId, 'message' => 'Connection test queued'];
         }
 
         $provider = $this->registry->resolve($telematic->provider);
         $provider->connect($telematic);
 
-        $credentials = json_decode(Crypt::decryptString($telematic->credentials), true);
+        $credentials = $this->getCredentials($telematic);
 
-        return $provider->testConnection($credentials);
+        $result = $provider->testConnection($credentials);
+        $this->recordConnectionTest($telematic, $result);
+
+        return $result;
     }
 
     /**
@@ -131,10 +137,19 @@ class TelematicService
      */
     public function discoverDevices(Telematic $telematic, array $options = []): string
     {
-        $job = new SyncDevicesJob($telematic, $options);
-        dispatch($job);
+        $jobId = (string) Str::uuid();
+        dispatch(new SyncTelematicDevicesJob($telematic, $options, $jobId));
+
+        $telematic->status = 'synchronizing';
+        $telematic->meta   = array_merge($telematic->meta ?? [], [
+            'last_sync_job_id'     => $jobId,
+            'last_sync_started_at' => now()->toDateTimeString(),
+            'last_sync_result'     => 'queued',
+            'last_sync_error'      => null,
+        ]);
+        $telematic->save();
 
-        return $job->getJobId();
+        return $jobId;
     }
 
     /**
@@ -142,22 +157,143 @@ class TelematicService
      */
     public function linkDevice(Telematic $telematic, array $deviceData): Device
     {
+        $externalId = $this->resolveExternalId($deviceData);
+
+        if (!$externalId) {
+            throw ValidationException::withMessages(['device_id' => ['Provider device identity is required to link a telematics device.']]);
+        }
+
         $device = Device::firstOrNew([
             'telematic_uuid' => $telematic->uuid,
-            'external_id'    => $deviceData['external_id'],
+            'device_id'      => $externalId,
         ]);
 
-        $device->device_name     = $deviceData['device_name'] ?? 'Unknown Device';
-        $device->device_model    = $deviceData['device_model'] ?? null;
-        $device->device_provider = $telematic->provider;
-        $device->status          = $deviceData['status'] ?? 'active';
-        $device->meta            = array_merge($device->meta ?? [], $deviceData['meta'] ?? []);
+        $device->company_uuid     = $telematic->company_uuid;
+        $device->name             = $deviceData['name'] ?? $deviceData['device_name'] ?? $device->name ?? 'Unknown Device';
+        $device->model            = $deviceData['model'] ?? $deviceData['device_model'] ?? $device->model;
+        $device->provider         = $deviceData['provider'] ?? $deviceData['device_provider'] ?? $telematic->provider;
+        $device->type             = $deviceData['type'] ?? null;
+        $device->internal_id      = $deviceData['internal_id'] ?? $externalId;
+        $device->imei             = $deviceData['imei'] ?? null;
+        $device->imsi             = $deviceData['imsi'] ?? null;
+        $device->serial_number    = $deviceData['serial_number'] ?? null;
+        $device->firmware_version = $deviceData['firmware_version'] ?? null;
+        $device->status           = $deviceData['status'] ?? $device->status ?? 'active';
+
+        if (array_key_exists('online', $deviceData) && $deviceData['online'] !== null) {
+            $device->online = (bool) $deviceData['online'];
+        } elseif (!$device->exists) {
+            $device->online = $device->status === 'active';
+        }
+
+        if (!empty($deviceData['last_online_at']) || !empty($deviceData['last_seen_at'])) {
+            $device->last_online_at = $deviceData['last_online_at'] ?? $deviceData['last_seen_at'];
+        }
+
+        $device->meta             = array_merge($device->meta ?? [], [
+            'external_id' => $externalId,
+        ], $deviceData['meta'] ?? []);
+
+        $location = $this->normalizeLocation($deviceData['location'] ?? null);
+        if ($location) {
+            $device->last_position = $location;
+        } elseif (!$device->exists || !$device->last_position) {
+            $device->last_position = $this->defaultLocation();
+        }
 
         $device->save();
 
         return $device;
     }
 
+    public function storeDeviceEvent(Telematic $telematic, array $eventData, ?Device $device = null): DeviceEvent
+    {
+        if (!$device) {
+            $device = $this->resolveDeviceForPayload($telematic, $eventData);
+        }
+
+        $eventKey            = $this->makeEventKey($telematic, $eventData, $device);
+        $event               = $eventKey ? DeviceEvent::firstOrNew(['_key' => $eventKey]) : new DeviceEvent();
+        $event->company_uuid = $telematic->company_uuid;
+        $event->device_uuid  = $device?->uuid;
+        $event->event_type   = $eventData['event_type'] ?? $eventData['type'] ?? 'telemetry_update';
+        $event->severity     = $eventData['severity'] ?? 'info';
+        $event->message      = $eventData['message'] ?? $eventData['reason'] ?? null;
+        $event->provider     = $telematic->provider;
+        $event->ident        = $eventData['ident'] ?? $eventData['event_id'] ?? $eventData['external_event_id'] ?? $eventData['external_id'] ?? null;
+        $event->code         = $eventData['code'] ?? null;
+        $event->state        = $eventData['state'] ?? null;
+        $event->reason       = $eventData['reason'] ?? null;
+        $event->occurred_at  = $eventData['occurred_at'] ?? $eventData['recorded_at'] ?? $eventData['timestamp'] ?? null;
+        $event->data         = $eventData['data'] ?? array_filter([
+            'speed'      => $eventData['speed'] ?? null,
+            'heading'    => $eventData['heading'] ?? null,
+            'odometer'   => $eventData['odometer'] ?? null,
+            'ignition'   => $eventData['ignition'] ?? null,
+            'fuel_level' => $eventData['fuel_level'] ?? null,
+        ], fn ($value) => $value !== null);
+        $event->payload      = $eventData['payload'] ?? $eventData['meta'] ?? $eventData;
+        $event->_key         = $eventKey;
+        $event->meta         = array_merge($eventData['meta'] ?? [], [
+            'telematic_uuid'    => $telematic->uuid,
+            'telematic_id'      => $telematic->public_id,
+            'provider_event_id' => $event->ident,
+            'occurred_at'       => $eventData['occurred_at'] ?? null,
+            'speed'             => $eventData['speed'] ?? null,
+            'heading'           => $eventData['heading'] ?? null,
+            'odometer'          => $eventData['odometer'] ?? null,
+            'ignition'          => $eventData['ignition'] ?? null,
+            'fuel_level'        => $eventData['fuel_level'] ?? null,
+        ]);
+
+        $location = $this->normalizeLocation($eventData['location'] ?? null);
+        if ($location) {
+            $event->location = $location;
+        }
+
+        $event->save();
+
+        return $event;
+    }
+
+    public function storeSensor(Telematic $telematic, array $sensorData, ?Device $device = null): Sensor
+    {
+        if (!$device) {
+            $device = $this->resolveDeviceForPayload($telematic, $sensorData);
+        }
+
+        $sensorIdentity = $sensorData['internal_id'] ?? $sensorData['sensor_id'] ?? $sensorData['external_id'] ?? null;
+        if (!$sensorIdentity && !$device) {
+            throw ValidationException::withMessages(['sensor_id' => ['Provider sensor identity or device identity is required to link a telematics sensor.']]);
+        }
+
+        $sensor = Sensor::firstOrNew([
+            'telematic_uuid' => $telematic->uuid,
+            'device_uuid'    => $device?->uuid,
+            'type'           => $sensorData['type'] ?? $sensorData['sensor_type'] ?? 'generic',
+            'internal_id'    => $sensorIdentity ?? $this->makeSensorIdentity($sensorData, $device),
+        ]);
+
+        $sensor->company_uuid     = $telematic->company_uuid;
+        $sensor->name             = $sensorData['name'] ?? $sensorData['sensor_type'] ?? $sensor->type ?? 'Sensor';
+        $sensor->unit             = $sensorData['unit'] ?? null;
+        $sensor->last_value       = isset($sensorData['value']) ? (string) $sensorData['value'] : $sensor->last_value;
+        $sensor->last_reading_at  = $sensorData['recorded_at'] ?? $sensorData['last_reading_at'] ?? $sensor->last_reading_at ?? now();
+        $sensor->status           = $sensorData['status'] ?? 'active';
+        $sensor->meta             = array_merge($sensor->meta ?? [], $sensorData['meta'] ?? []);
+
+        $location = $this->normalizeLocation($sensorData['location'] ?? null);
+        if ($location) {
+            $sensor->last_position = $location;
+        } elseif (!$sensor->exists || !$sensor->last_position) {
+            $sensor->last_position = $this->defaultLocation();
+        }
+
+        $sensor->save();
+
+        return $sensor;
+    }
+
     /**
      * Get devices for a telematic.
      *
@@ -173,14 +309,28 @@ class TelematicService
 
         if (isset($filters['search'])) {
             $query->where(function ($q) use ($filters) {
-                $q->where('device_name', 'like', "%{$filters['search']}%")
-                  ->orWhere('external_id', 'like', "%{$filters['search']}%");
+                $q->where('name', 'like', "%{$filters['search']}%")
+                    ->orWhere('device_id', 'like', "%{$filters['search']}%")
+                    ->orWhere('internal_id', 'like', "%{$filters['search']}%")
+                    ->orWhere('imei', 'like', "%{$filters['search']}%");
             });
         }
 
         return $query->get();
     }
 
+    public function recordConnectionTest(Telematic $telematic, array $result): void
+    {
+        $telematic->status = ($result['success'] ?? false) ? 'connected' : 'error';
+        $telematic->meta   = array_merge($telematic->meta ?? [], [
+            'last_connection_test' => now()->toDateTimeString(),
+            'last_test_result'     => ($result['success'] ?? false) ? 'success' : 'failed',
+            'last_error'           => ($result['success'] ?? false) ? null : ($result['message'] ?? 'Connection test failed'),
+            'last_test_metadata'   => $result['metadata'] ?? [],
+        ]);
+        $telematic->save();
+    }
+
     /**
      * Validate credentials against provider schema.
      *
@@ -218,6 +368,175 @@ class TelematicService
      */
     public function getCredentials(Telematic $telematic): array
     {
-        return json_decode(Crypt::decryptString($telematic->credentials), true);
+        if (is_array($telematic->credentials)) {
+            return $telematic->credentials;
+        }
+
+        $credentials = $telematic->credentials;
+        if (!$credentials) {
+            return [];
+        }
+
+        try {
+            return json_decode(Crypt::decryptString($credentials), true) ?? [];
+        } catch (\Throwable) {
+            return json_decode($credentials, true) ?? [];
+        }
+    }
+
+    protected function encryptCredentials(array $credentials): string
+    {
+        return Crypt::encryptString(json_encode($credentials));
+    }
+
+    protected function resolveDeviceForPayload(Telematic $telematic, array $payload): ?Device
+    {
+        $externalId = $this->resolveExternalId($payload);
+
+        if (!$externalId) {
+            return null;
+        }
+
+        return Device::where('telematic_uuid', $telematic->uuid)
+            ->where(function ($query) use ($externalId) {
+                $query->where('device_id', $externalId)
+                    ->orWhere('internal_id', $externalId)
+                    ->orWhere('imei', $externalId);
+            })
+            ->first();
+    }
+
+    public function resolveWebhookTelematic(string $providerKey, array $payload = [], array $headers = [], ?string $integrationId = null): ?Telematic
+    {
+        $query = Telematic::where('provider', $providerKey);
+
+        if ($integrationId) {
+            return (clone $query)
+                ->where(function ($query) use ($integrationId) {
+                    $query->where('public_id', $integrationId)->orWhere('uuid', $integrationId);
+                })
+                ->first();
+        }
+
+        $providerAccountId = $this->resolveProviderAccountId($payload, $headers);
+        if ($providerAccountId) {
+            $matches = (clone $query)
+                ->where(function ($query) use ($providerAccountId) {
+                    $query->where('meta->provider_account_id', $providerAccountId)
+                        ->orWhere('meta->account_id', $providerAccountId)
+                        ->orWhere('meta->organization_id', $providerAccountId)
+                        ->orWhere('meta->customer_id', $providerAccountId);
+                })
+                ->limit(2)
+                ->get();
+
+            if ($matches->count() === 1) {
+                return $matches->first();
+            }
+        }
+
+        $deviceId = $this->resolveExternalId($payload);
+        if ($deviceId) {
+            $matches = (clone $query)
+                ->whereHas('device', function ($query) use ($deviceId) {
+                    $query->where('device_id', $deviceId)
+                        ->orWhere('internal_id', $deviceId)
+                        ->orWhere('imei', $deviceId);
+                })
+                ->limit(2)
+                ->get();
+
+            if ($matches->count() === 1) {
+                return $matches->first();
+            }
+        }
+
+        return null;
+    }
+
+    protected function normalizeLocation(?array $location): mixed
+    {
+        if (!$location) {
+            return null;
+        }
+
+        $lat = $location['lat'] ?? $location['latitude'] ?? null;
+        $lng = $location['lng'] ?? $location['longitude'] ?? null;
+
+        if ($lat === null || $lng === null) {
+            return null;
+        }
+
+        return ['latitude' => (float) $lat, 'longitude' => (float) $lng];
+    }
+
+    protected function defaultLocation(): array
+    {
+        return ['latitude' => 0, 'longitude' => 0];
+    }
+
+    protected function resolveExternalId(array $payload): ?string
+    {
+        $value = $payload['device_id']
+            ?? $payload['external_id']
+            ?? $payload['ident']
+            ?? $payload['unit_id']
+            ?? $payload['vehicle_id']
+            ?? $payload['imei']
+            ?? null;
+
+        return $value === null || $value === '' ? null : (string) $value;
+    }
+
+    protected function resolveProviderAccountId(array $payload, array $headers = []): ?string
+    {
+        $headerValue = data_get($headers, 'x-provider-account.0')
+            ?? data_get($headers, 'x-organization-id.0')
+            ?? data_get($headers, 'x-customer-id.0');
+
+        $value = $payload['provider_account_id']
+            ?? $payload['account_id']
+            ?? $payload['organization_id']
+            ?? $payload['org_id']
+            ?? $payload['customer_id']
+            ?? data_get($payload, 'account.id')
+            ?? data_get($payload, 'organization.id')
+            ?? $headerValue;
+
+        return $value === null || $value === '' ? null : (string) $value;
+    }
+
+    protected function makeEventKey(Telematic $telematic, array $eventData, ?Device $device = null): ?string
+    {
+        $deviceId = $device?->device_id ?? $this->resolveExternalId($eventData);
+        if (!$deviceId) {
+            return null;
+        }
+
+        $providerEventId = $eventData['event_id'] ?? $eventData['external_event_id'] ?? $eventData['ident'] ?? $eventData['external_id'] ?? null;
+        $occurredAt      = $eventData['occurred_at'] ?? $eventData['recorded_at'] ?? $eventData['timestamp'] ?? null;
+        $eventType       = $eventData['event_type'] ?? $eventData['type'] ?? 'telemetry_update';
+
+        if (!$providerEventId && !$occurredAt) {
+            return null;
+        }
+
+        return sha1(implode('|', [
+            $telematic->provider,
+            $telematic->public_id ?? $telematic->uuid,
+            $deviceId,
+            $providerEventId,
+            $eventType,
+            $occurredAt,
+        ]));
+    }
+
+    protected function makeSensorIdentity(array $sensorData, ?Device $device = null): string
+    {
+        return sha1(implode('|', [
+            $device?->uuid ?? 'no-device',
+            $sensorData['type'] ?? $sensorData['sensor_type'] ?? 'generic',
+            $sensorData['name'] ?? $sensorData['unit'] ?? 'sensor',
+        ]));
     }
 }