@fleetbase/fleetops-engine 0.6.54 → 0.6.56

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

@@ -2,6 +2,8 @@
 
 namespace Fleetbase\FleetOps\Support\Telematics\Providers;
 
+use Illuminate\Support\Carbon;
+
 /**
  * Class SamsaraProvider.
  *
@@ -78,30 +80,68 @@ class SamsaraProvider extends AbstractProvider
 
     public function normalizeDevice(array $payload): array
     {
+        $position = $this->extractPosition($payload);
+
         return [
-            'external_id'     => $payload['id'],
-            'device_name'     => $payload['name'] ?? 'Unknown Device',
-            'device_provider' => 'samsara',
-            'device_model'    => $payload['make'] ?? null,
-            'vin'             => $payload['vin'] ?? null,
-            'license_plate'   => $payload['licensePlate'] ?? null,
-            'status'          => 'active',
-            'meta'            => $payload,
+            'device_id'      => $payload['id'] ?? null,
+            'external_id'    => $payload['id'] ?? null,
+            'name'           => $payload['name'] ?? 'Unknown Device',
+            'provider'       => 'samsara',
+            'model'          => $payload['make'] ?? $payload['model'] ?? null,
+            'vin'            => $payload['vin'] ?? null,
+            'serial_number'  => $payload['serial'] ?? $payload['serialNumber'] ?? null,
+            'license_plate'  => $payload['licensePlate'] ?? null,
+            'status'         => $this->normalizeStatus($payload),
+            'online'         => $this->resolveOnline($payload),
+            'last_seen_at'   => $this->parseTimestamp($payload['time'] ?? data_get($payload, 'location.time') ?? data_get($payload, 'gps.time') ?? null),
+            'location'       => [
+                'lat' => $position['lat'] ?? null,
+                'lng' => $position['lng'] ?? null,
+            ],
+            'speed'      => $this->extractSpeed($payload),
+            'heading'    => $this->extractHeading($payload),
+            'altitude'   => $this->extractAltitude($payload),
+            'odometer'   => data_get($payload, 'odometerMeters') ?? data_get($payload, 'obdOdometerMeters.value'),
+            'fuel_level' => data_get($payload, 'fuelPercent.value') ?? data_get($payload, 'fuelPercent'),
+            'meta'       => [
+                'raw'             => $payload,
+                'provider_status' => array_filter([
+                    'status'         => $payload['status'] ?? null,
+                    'gateway_status' => data_get($payload, 'gateway.status'),
+                    'online'         => $payload['online'] ?? $payload['isOnline'] ?? data_get($payload, 'gateway.online'),
+                ], fn ($value) => $value !== null),
+            ],
         ];
     }
 
     public function normalizeEvent(array $payload): array
     {
+        $position = $this->extractPosition($payload);
+        $deviceId = data_get($payload, 'vehicle.id') ?? $payload['vehicleId'] ?? $payload['id'] ?? null;
+
         return [
-            'external_id' => $payload['id'] ?? null,
-            'device_id'   => $payload['vehicle']['id'] ?? $payload['vehicleId'] ?? null,
+            'external_id' => $payload['id'] ?? $deviceId,
+            'device_id'   => $deviceId,
             'event_type'  => $payload['eventType'] ?? 'vehicle_update',
-            'occurred_at' => $payload['time'] ?? now(),
+            'occurred_at' => $this->parseTimestamp($payload['time'] ?? data_get($payload, 'location.time') ?? data_get($payload, 'gps.time') ?? null) ?? now(),
+            'online'      => $this->resolveOnline($payload),
             'location'    => [
-                'lat' => $payload['location']['latitude'] ?? null,
-                'lng' => $payload['location']['longitude'] ?? null,
+                'lat' => $position['lat'] ?? null,
+                'lng' => $position['lng'] ?? null,
+            ],
+            'speed'      => $this->extractSpeed($payload),
+            'heading'    => $this->extractHeading($payload),
+            'altitude'   => $this->extractAltitude($payload),
+            'odometer'   => data_get($payload, 'odometerMeters') ?? data_get($payload, 'obdOdometerMeters.value'),
+            'fuel_level' => data_get($payload, 'fuelPercent.value') ?? data_get($payload, 'fuelPercent'),
+            'meta'       => [
+                'raw'             => $payload,
+                'provider_status' => array_filter([
+                    'status'         => $payload['status'] ?? null,
+                    'gateway_status' => data_get($payload, 'gateway.status'),
+                    'online'         => $payload['online'] ?? $payload['isOnline'] ?? data_get($payload, 'gateway.online'),
+                ], fn ($value) => $value !== null),
             ],
-            'meta' => $payload,
         ];
     }
 
@@ -176,4 +216,72 @@ class SamsaraProvider extends AbstractProvider
     {
         return true;
     }
+
+    protected function extractPosition(array $payload): array
+    {
+        $position = $payload['location']
+            ?? $payload['gps']
+            ?? $payload['currentLocation']
+            ?? $payload['lastKnownLocation']
+            ?? data_get($payload, 'vehicle.location')
+            ?? [];
+
+        return [
+            'lat' => $position['latitude'] ?? $position['lat'] ?? null,
+            'lng' => $position['longitude'] ?? $position['lng'] ?? null,
+        ];
+    }
+
+    protected function extractSpeed(array $payload): mixed
+    {
+        return data_get($payload, 'location.speedMilesPerHour')
+            ?? data_get($payload, 'location.speed')
+            ?? data_get($payload, 'gps.speedMilesPerHour')
+            ?? data_get($payload, 'speedMilesPerHour')
+            ?? data_get($payload, 'speed');
+    }
+
+    protected function extractHeading(array $payload): mixed
+    {
+        return data_get($payload, 'location.headingDegrees')
+            ?? data_get($payload, 'location.heading')
+            ?? data_get($payload, 'gps.headingDegrees')
+            ?? data_get($payload, 'headingDegrees')
+            ?? data_get($payload, 'heading');
+    }
+
+    protected function extractAltitude(array $payload): mixed
+    {
+        return data_get($payload, 'location.altitudeMeters')
+            ?? data_get($payload, 'gps.altitudeMeters')
+            ?? data_get($payload, 'altitudeMeters')
+            ?? data_get($payload, 'altitude');
+    }
+
+    protected function parseTimestamp($value): ?string
+    {
+        if (!$value) {
+            return null;
+        }
+
+        return Carbon::parse($value)->toDateTimeString();
+    }
+
+    protected function resolveOnline(array $payload): ?bool
+    {
+        $value = $payload['online'] ?? $payload['isOnline'] ?? data_get($payload, 'gateway.online') ?? null;
+
+        if ($value === null) {
+            return $this->extractPosition($payload)['lat'] !== null;
+        }
+
+        return filter_var($value, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE) ?? (bool) $value;
+    }
+
+    protected function normalizeStatus(array $payload): string
+    {
+        $status = strtolower((string) ($payload['status'] ?? data_get($payload, 'gateway.status') ?? 'active'));
+
+        return in_array($status, ['inactive', 'offline', 'deactivated'], true) ? 'inactive' : 'active';
+    }
 }

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

@@ -194,19 +194,30 @@ class TelematicService
     {
         $device = $this->linkDevice($telematic, $provider->normalizeDevice($payload));
 
-        $event = null;
+        $event  = null;
+        $events = [];
         try {
-            $eventData = $provider->normalizeEvent($payload);
-            if ($this->hasEventSignal($eventData)) {
-                $event = $this->storeDeviceEvent($telematic, $eventData, $device);
+            $eventPayloads = method_exists($provider, 'normalizeEvents') ? $provider->normalizeEvents($payload) : [];
+            if (empty($eventPayloads)) {
+                $eventPayloads = [$provider->normalizeEvent($payload)];
+            }
+
+            foreach ($eventPayloads as $eventData) {
+                if ($this->hasEventSignal($eventData)) {
+                    $storedEvent = $this->storeDeviceEvent($telematic, $eventData, $device);
+                    $events[]    = $storedEvent;
+                    $event ??= $storedEvent;
+                }
             }
         } catch (\Throwable) {
-            $event = null;
+            $event  = null;
+            $events = [];
         }
 
         return [
             'device'  => $device,
             'event'   => $event,
+            'events'  => $events,
             'sensors' => $this->storeSnapshotSensors($telematic, $provider, $payload, $device),
         ];
     }
@@ -663,6 +674,10 @@ class TelematicService
             $vehicle->altitude = $eventData['altitude'];
         }
 
+        if (array_key_exists('odometer', $eventData) && $eventData['odometer'] !== null) {
+            $vehicle->odometer = $eventData['odometer'];
+        }
+
         $vehicle->telematics = array_merge($vehicle->telematics ?? [], [
             'last_event_uuid'     => $event->uuid,
             'last_event_id'       => $event->public_id,
@@ -757,13 +772,17 @@ class TelematicService
         return collect($rawSensors)
             ->map(function ($sensor, $name) {
                 if (is_array($sensor)) {
-                    return array_merge(['name' => $name], $sensor);
+                    return array_merge([
+                        'sensor_key' => $name,
+                        'name'       => $name,
+                    ], $sensor);
                 }
 
                 return [
-                    'name'  => $name,
-                    'type'  => $name,
-                    'value' => $sensor,
+                    'sensor_key' => $name,
+                    'name'       => $name,
+                    'type'       => $name,
+                    'value'      => $sensor,
                 ];
             })
             ->values()

package/server/src/routes.php

@@ -105,6 +105,61 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                 $router->put('{id}', 'FuelReportController@update');
                 $router->delete('{id}', 'FuelReportController@delete');
             });
+            // fuel-transactions routes
+            $router->group(['prefix' => 'fuel-transactions'], function () use ($router) {
+                $router->post('/', 'FuelTransactionController@create');
+                $router->get('/', 'FuelTransactionController@query');
+                $router->get('{id}', 'FuelTransactionController@find');
+                $router->put('{id}', 'FuelTransactionController@update');
+                $router->delete('{id}', 'FuelTransactionController@delete');
+                $router->post('{id}/match-vehicle', 'FuelTransactionController@matchVehicle');
+                $router->post('{id}/match-order', 'FuelTransactionController@matchOrder');
+                $router->post('{id}/reprocess', 'FuelTransactionController@reprocess');
+                $router->post('{id}/review', 'FuelTransactionController@review');
+            });
+            // equipment routes
+            $router->group(['prefix' => 'equipment'], function () use ($router) {
+                $router->post('/', 'EquipmentController@create');
+                $router->get('/', 'EquipmentController@query');
+                $router->get('{id}', 'EquipmentController@find');
+                $router->put('{id}', 'EquipmentController@update');
+                $router->delete('{id}', 'EquipmentController@delete');
+            });
+            // parts routes
+            $router->group(['prefix' => 'parts'], function () use ($router) {
+                $router->post('/', 'PartController@create');
+                $router->get('/', 'PartController@query');
+                $router->get('{id}', 'PartController@find');
+                $router->put('{id}', 'PartController@update');
+                $router->delete('{id}', 'PartController@delete');
+            });
+            // work-orders routes
+            $router->group(['prefix' => 'work-orders'], function () use ($router) {
+                $router->post('/', 'WorkOrderController@create');
+                $router->get('/', 'WorkOrderController@query');
+                $router->get('{id}', 'WorkOrderController@find');
+                $router->put('{id}', 'WorkOrderController@update');
+                $router->delete('{id}', 'WorkOrderController@delete');
+                $router->post('{id}/send', 'WorkOrderController@send');
+            });
+            // devices routes
+            $router->group(['prefix' => 'devices'], function () use ($router) {
+                $router->post('/', 'DeviceController@create');
+                $router->get('/', 'DeviceController@query');
+                $router->get('{id}', 'DeviceController@find');
+                $router->put('{id}', 'DeviceController@update');
+                $router->delete('{id}', 'DeviceController@delete');
+                $router->post('{id}/attach', 'DeviceController@attach');
+                $router->post('{id}/detach', 'DeviceController@detach');
+            });
+            // sensors routes
+            $router->group(['prefix' => 'sensors'], function () use ($router) {
+                $router->post('/', 'SensorController@create');
+                $router->get('/', 'SensorController@query');
+                $router->get('{id}', 'SensorController@find');
+                $router->put('{id}', 'SensorController@update');
+                $router->delete('{id}', 'SensorController@delete');
+            });
             // orders routes
             $router->group(['prefix' => 'orders', 'middleware' => []], function () use ($router) {
                 $router->post('/', 'OrderController@create');
@@ -315,7 +370,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                                 $router->get('facilitators/{id}', $controller('getAsFacilitator'));
                                 $router->get('customers/{id}', $controller('getAsCustomer'));
                                 $router->post('{id}/convert-to-vendor', $controller('convertToVendor'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                             }
                         );
                         $router->fleetbaseRoutes(
@@ -330,7 +384,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                                 $router->post('{id}/assign-vehicle', $controller('assignVehicle'));
                                 $router->post('{id}/unassign-vehicle', $controller('unassignVehicle'));
                                 $router->match(['get', 'post'], 'export', $controller('export'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                                 $router->post('import', $controller('import'));
                                 // Driver scheduling endpoints
                                 $router->get('{id}/schedule-items', $controller('scheduleItems'));
@@ -349,7 +402,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                                 $router->post('remove-vehicle', $controller('removeVehicle'));
                                 $router->match(['get', 'post'], 'export', $controller('export'));
                                 $router->post('import', $controller('import'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                             }
                         );
                         $router->fleetbaseRoutes(
@@ -357,7 +409,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                             function ($router, $controller) {
                                 $router->match(['get', 'post'], 'export', $controller('export'));
                                 $router->post('import', $controller('import'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                             }
                         );
                         $router->fleetbaseRoutes(
@@ -385,14 +436,12 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                             function ($router, $controller) {
                                 $router->match(['get', 'post'], 'export', $controller('export'));
                                 $router->post('import', $controller('import'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                             }
                         );
                         $router->fleetbaseRoutes(
                             'integrated-vendors',
                             function ($router, $controller) {
                                 $router->get('supported', $controller('getSupported'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                             }
                         );
                         $router->fleetbaseRoutes(
@@ -421,7 +470,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                                 $router->patch('start', $controller('start'));
                                 // Scheduler: set scheduled_at + driver without triggering dispatch
                                 $router->patch('schedule', $controller('scheduleOrder'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                                 $router->match(['get', 'post'], 'export', $controller('export'));
                             }
                         );
@@ -434,7 +482,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                                 $router->get('lookup', $controller('geocode'))->middleware(['cache.headers:private;max_age=3600']);
                                 $router->get('avatars', $controller('avatars'));
                                 $router->match(['get', 'post'], 'export', $controller('export'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                                 $router->post('import', $controller('import'));
                             }
                         );
@@ -449,7 +496,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                             'service-areas',
                             function ($router, $controller) {
                                 $router->match(['get', 'post'], 'export', $controller('export'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                             }
                         );
                         $router->group(
@@ -473,10 +519,8 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                         $router->fleetbaseRoutes(
                             'service-rates',
                             function ($router, $controller) {
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                                 $router->get('for-route', $controller('getServicesForRoute'));
                                 $router->match(['get', 'post'], 'export', $controller('export'));
-                                $router->get('for-route', $controller('getServicesForRoute'));
                             }
                         );
                         $router->fleetbaseRoutes('tracking-numbers');
@@ -494,7 +538,6 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                                 $router->post('{id}/detach-device', $controller('detachDevice'));
                                 $router->match(['get', 'post'], 'export', $controller('export'));
                                 $router->post('import', $controller('import'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                             }
                         );
                         $router->fleetbaseRoutes('vehicle-devices');
@@ -510,18 +553,22 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                                 $router->delete('{id}/personnels/{contact}', $controller('removeVendorPersonnel'));
                                 $router->post('{id}/assign-driver', $controller('assignDriver'));
                                 $router->post('{id}/remove-driver', $controller('removeDriver'));
-                                $router->delete('bulk-delete', $controller('bulkDelete'));
                                 $router->post('import', $controller('import'));
                             }
                         );
-                        $router->fleetbaseRoutes('devices');
+                        $router->fleetbaseRoutes('devices', function ($router, $controller) {
+                            $router->match(['get', 'post'], 'export', $controller('export'));
+                        });
                         $router->post('devices/{id}/attach', 'DeviceController@attach');
                         $router->post('devices/{id}/detach', 'DeviceController@detach');
                         $router->fleetbaseRoutes('device-events', function ($router, $controller) {
                             $router->post('{id}/mark-processed', $controller('markProcessed'));
                         });
-                        $router->fleetbaseRoutes('sensors');
+                        $router->fleetbaseRoutes('sensors', function ($router, $controller) {
+                            $router->match(['get', 'post'], 'export', $controller('export'));
+                        });
                         $router->fleetbaseRoutes('telematics', function ($router, $controller) {
+                            $router->match(['get', 'post'], 'export', $controller('export'));
                             $router->get('providers', $controller('providers'));
                             $router->get('{id}/logs', $controller('logs'));
                             $router->get('{id}/devices', $controller('devices'));
@@ -531,6 +578,7 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                             $router->post('{key}/test-credentials', $controller('testCredentials'));
                         });
                         $router->fleetbaseRoutes('maintenance-schedules', function ($router, $controller) {
+                            $router->match(['get', 'post'], 'export', $controller('export'));
                             $router->post('import', $controller('import'));
                             $router->post('{id}/pause', $controller('pause'));
                             $router->post('{id}/resume', $controller('resume'));
@@ -539,19 +587,23 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                             $router->get('{id}/ical', $controller('ical'));
                         });
                         $router->fleetbaseRoutes('work-orders', function ($router, $controller) {
+                            $router->match(['get', 'post'], 'export', $controller('export'));
                             $router->post('import', $controller('import'));
                             $router->post('{id}/send', $controller('sendEmail'));
                         });
                         $router->fleetbaseRoutes('maintenances', function ($router, $controller) {
+                            $router->match(['get', 'post'], 'export', $controller('export'));
                             $router->post('import', $controller('import'));
                             $router->post('{id}/line-items', $controller('addLineItem'));
                             $router->put('{id}/line-items/{index}', $controller('updateLineItem'));
                             $router->delete('{id}/line-items/{index}', $controller('removeLineItem'));
                         });
                         $router->fleetbaseRoutes('equipment', function ($router, $controller) {
+                            $router->match(['get', 'post'], 'export', $controller('export'));
                             $router->post('import', $controller('import'));
                         });
                         $router->fleetbaseRoutes('parts', function ($router, $controller) {
+                            $router->match(['get', 'post'], 'export', $controller('export'));
                             $router->post('import', $controller('import'));
                         });
                         $router->fleetbaseRoutes('warranties');

package/server/tests/DeviceFilterTest.php

@@ -9,6 +9,8 @@ test('device filter exposes telematics detail filter contract', function () {
         ->toContain("'vehicle'")
         ->toContain("'connection_status'")
         ->toContain("'device_id'")
+        ->toContain("'type'")
+        ->toContain("'serial_number'")
         ->toContain("'last_online_at'")
         ->toContain("'updated_at'");
 
@@ -16,8 +18,13 @@ test('device filter exposes telematics detail filter contract', function () {
         ->toContain('public function query(?string $searchQuery)')
         ->toContain('public function deviceId(?string $deviceId)')
         ->toContain("where('device_id', 'like'")
+        ->toContain('public function type(string|array|null $type)')
+        ->toContain("whereIn('type', \$type)")
+        ->toContain('public function serialNumber(?string $serialNumber)')
+        ->toContain("where('serial_number', 'like'")
         ->toContain('public function vehicle(?string $vehicle)')
         ->toContain("where('attachable_uuid', \$vehicle)")
+        ->toContain("where('public_id', \$vehicle)")
         ->toContain('public function connectionStatus')
         ->toContain("'online'")
         ->toContain("'recently_offline'")
@@ -30,7 +37,9 @@ test('device filter exposes telematics detail filter contract', function () {
         ->toContain('protected function filterDate');
 
     expect($controller)
+        ->toContain("withCount('sensors')")
         ->toContain("filled('connection_status')")
+        ->toContain("filled('serial_number')")
         ->toContain("filled('last_online_at')")
         ->toContain("filled('updated_at')");
 });

package/server/tests/DriverVehicleStatusDefaultTest.php

@@ -1,16 +1,19 @@
 <?php
 
 use Fleetbase\FleetOps\Models\Driver;
+use Fleetbase\FleetOps\Models\Equipment;
 use Fleetbase\FleetOps\Models\Vehicle;
 
-test('driver and vehicle statuses default to available', function () {
+test('driver vehicle and equipment statuses default to available', function () {
     expect((new Driver())->status)
         ->toBe('available')
         ->and((new Vehicle())->status)
+        ->toBe('available')
+        ->and((new Equipment())->status)
         ->toBe('available');
 });
 
-test('legacy active and null driver and vehicle statuses normalize to available', function () {
+test('legacy active and null driver vehicle and equipment statuses normalize to available', function () {
     $driver         = new Driver();
     $driver->status = 'active';
     expect($driver->status)->toBe('available');
@@ -24,6 +27,20 @@ test('legacy active and null driver and vehicle statuses normalize to available'
 
     $vehicle->status = null;
     expect($vehicle->status)->toBe('available');
+
+    $equipment         = new Equipment();
+    $equipment->status = 'active';
+    expect($equipment->status)->toBe('available');
+
+    $equipment->status = null;
+    expect($equipment->status)->toBe('available');
+});
+
+test('equipment preserves explicit non default status values', function () {
+    $equipment         = new Equipment();
+    $equipment->status = 'maintenance';
+
+    expect($equipment->status)->toBe('maintenance');
 });
 
 test('dispatch driver availability queries use available status', function () {

package/server/tests/EquipmentAssignmentMorphTypeTest.php

@@ -0,0 +1,35 @@
+<?php
+
+use Fleetbase\FleetOps\Models\Driver;
+use Fleetbase\FleetOps\Models\Equipment;
+use Fleetbase\FleetOps\Models\Vehicle;
+use Illuminate\Database\Eloquent\Relations\Relation;
+
+test('equipment assignment type aliases normalize to model classes', function () {
+    $equipment = new Equipment();
+
+    $equipment->equipable_type = 'fleet-ops:vehicle';
+    expect($equipment->equipable_type)->toBe(Vehicle::class);
+
+    $equipment->equipable_type = 'fleet-ops:driver';
+    expect($equipment->equipable_type)->toBe(Driver::class);
+});
+
+test('equipment assignment type preserves null and existing model classes', function () {
+    $equipment = new Equipment();
+
+    $equipment->equipable_type = null;
+    expect($equipment->equipable_type)->toBeNull();
+
+    $equipment->equipable_type = Vehicle::class;
+    expect($equipment->equipable_type)->toBe(Vehicle::class);
+});
+
+test('legacy equipment assignment aliases are registered for morph reads', function () {
+    new Equipment();
+
+    expect(Relation::getMorphedModel('fleet-ops:vehicle'))
+        ->toBe(Vehicle::class)
+        ->and(Relation::getMorphedModel('fleet-ops:driver'))
+        ->toBe(Driver::class);
+});

package/server/tests/ExportCoverageTest.php

@@ -0,0 +1,79 @@
+<?php
+
+use Fleetbase\FleetOps\Exports\DeviceExport;
+use Fleetbase\FleetOps\Exports\MaintenanceExport;
+use Fleetbase\FleetOps\Exports\MaintenanceScheduleExport;
+use Fleetbase\FleetOps\Exports\VehicleExport;
+use Fleetbase\FleetOps\Exports\WorkOrderExport;
+
+test('expanded export headings include important operational fields', function () {
+    expect((new VehicleExport())->headings())
+        ->toContain('Plate Number')
+        ->toContain('VIN')
+        ->toContain('Fuel Card Number')
+        ->toContain('Status')
+        ->toContain('Body Type')
+        ->toContain('Usage Type')
+        ->toContain('Transmission')
+        ->toContain('Measurement System')
+        ->toContain('Engine Number')
+        ->toContain('Engine Size (L)')
+        ->toContain('Payload Capacity (kg)')
+        ->toContain('Payload Volume (m3)')
+        ->toContain('DPF Equipped')
+        ->toContain('Insurance Value')
+        ->toContain('Loan Amount')
+        ->toContain('Vehicle Skills')
+        ->toContain('Updated At');
+
+    expect((new WorkOrderExport())->headings())
+        ->toContain('Assignee')
+        ->toContain('Target')
+        ->toContain('Due At')
+        ->toContain('Completion Percentage');
+
+    expect((new DeviceExport())->headings())
+        ->toContain('Connection Status')
+        ->toContain('Attached To')
+        ->toContain('Telematic Provider')
+        ->toContain('Last Seen');
+});
+
+test('relationship exports use readable name columns', function () {
+    expect((new VehicleExport())->headings())
+        ->toContain('Driver')
+        ->toContain('Vendor');
+
+    expect((new WorkOrderExport())->headings())
+        ->toContain('Assignee')
+        ->toContain('Target');
+
+    expect((new MaintenanceExport())->headings())
+        ->toContain('Asset')
+        ->toContain('Performed By');
+
+    expect((new MaintenanceScheduleExport())->headings())
+        ->toContain('Subject')
+        ->toContain('Default Assignee');
+});
+
+test('vehicle export helpers format spreadsheet friendly values', function () {
+    $export = new VehicleExport();
+    $helper = fn (string $method, ...$arguments) => (new ReflectionMethod($export, $method))->invoke($export, ...$arguments);
+
+    expect($helper('yesNo', true))->toBe('Yes')
+        ->and($helper('yesNo', false))->toBe('No')
+        ->and($helper('yesNo', null))->toBeNull()
+        ->and($helper('joinSkills', ['hazmat', 'refrigerated']))->toBe('hazmat, refrigerated')
+        ->and($helper('joinSkills', []))->toBeNull();
+});
+
+test('resources with visible export actions have backend export routes', function () {
+    $routes = file_get_contents(dirname(__DIR__) . '/src/routes.php');
+
+    foreach (['devices', 'sensors', 'telematics', 'maintenance-schedules', 'work-orders', 'maintenances', 'equipment', 'parts'] as $resource) {
+        expect($routes)->toContain("\$router->fleetbaseRoutes('{$resource}'");
+    }
+
+    expect(substr_count($routes, "\$router->match(['get', 'post'], 'export', \$controller('export'));"))->toBeGreaterThanOrEqual(19);
+});