@fleetbase/fleetops-engine 0.6.58 → 0.6.59

package/server/tests/VehicleResourceContractsTest.php

@@ -0,0 +1,313 @@
+<?php
+
+use Fleetbase\FleetOps\Http\Resources\v1\Vehicle as VehicleResource;
+use Fleetbase\FleetOps\Http\Resources\v1\VehicleWithoutDriver as VehicleWithoutDriverResource;
+use Illuminate\Http\Request;
+
+class FleetOpsVehicleResourceRouteFixture
+{
+    public function __construct(private string $uri)
+    {
+    }
+
+    public function uri(): string
+    {
+        return $this->uri;
+    }
+}
+
+class FleetOpsVehicleResourceFixture implements ArrayAccess
+{
+    public function __construct(private array $attributes)
+    {
+    }
+
+    public function __get(string $key): mixed
+    {
+        return $this->attributes[$key] ?? null;
+    }
+
+    public function __isset(string $key): bool
+    {
+        return array_key_exists($key, $this->attributes);
+    }
+
+    public function offsetExists(mixed $offset): bool
+    {
+        return array_key_exists((string) $offset, $this->attributes);
+    }
+
+    public function offsetGet(mixed $offset): mixed
+    {
+        return $this->attributes[(string) $offset] ?? null;
+    }
+
+    public function offsetSet(mixed $offset, mixed $value): void
+    {
+        $this->attributes[(string) $offset] = $value;
+    }
+
+    public function offsetUnset(mixed $offset): void
+    {
+        unset($this->attributes[(string) $offset]);
+    }
+
+    public function relationLoaded(string $relationship): bool
+    {
+        return false;
+    }
+
+    public function loadMissing(string $relationship): self
+    {
+        return $this;
+    }
+
+    public function getOriginal(string $key): mixed
+    {
+        return $this->attributes['original'][$key] ?? $this->attributes[$key] ?? null;
+    }
+
+    public function withCustomFields(array $payload): array
+    {
+        return $payload;
+    }
+}
+
+class TestFleetOpsVehicleResource extends VehicleResource
+{
+    protected function assignedOrdersCount(): int
+    {
+        return 3;
+    }
+
+    protected function currentOrderReference(): ?string
+    {
+        return 'order_current';
+    }
+}
+
+function fleetopsVehicleResourceRequest(bool $internal): Request
+{
+    $uri     = $internal ? 'api/int/v1/fleet-ops/vehicles/vehicle_123' : 'api/v1/fleet-ops/vehicles/vehicle_123';
+    $request = Request::create('/' . $uri, 'GET');
+
+    $request->setRouteResolver(fn () => new FleetOpsVehicleResourceRouteFixture($uri));
+    app()->instance('request', $request);
+
+    return $request;
+}
+
+function fleetopsVehicleResourceFixture(array $overrides = []): FleetOpsVehicleResourceFixture
+{
+    return new FleetOpsVehicleResourceFixture(array_merge([
+        'id'                                   => 42,
+        'uuid'                                 => 'vehicle-uuid',
+        'public_id'                            => 'vehicle_public',
+        'internal_id'                          => 'VEH-42',
+        'company_uuid'                         => 'company-uuid',
+        'vendor_uuid'                          => 'vendor-uuid',
+        'category_uuid'                        => 'category-uuid',
+        'warranty_uuid'                        => 'warranty-uuid',
+        'telematic_uuid'                       => 'telematic-uuid',
+        'photo_uuid'                           => 'photo-uuid',
+        'photo_url'                            => 'https://cdn.test/photo.png',
+        'avatar_url'                           => 'https://cdn.test/avatar.png',
+        'original'                             => ['avatar_url' => 'avatar-upload-token'],
+        'name'                                 => 'Truck 42',
+        'display_name'                         => 'Truck 42 Display',
+        'description'                          => 'Primary city truck',
+        'driver_name'                          => 'Jane Driver',
+        'vendor_name'                          => 'Vendor One',
+        'make'                                 => 'Ford',
+        'model'                                => 'Transit',
+        'model_type'                           => 'Cargo',
+        'year'                                 => 2025,
+        'trim'                                 => 'XL',
+        'type'                                 => 'van',
+        'class'                                => 'commercial',
+        'color'                                => 'white',
+        'serial_number'                        => 'SER-42',
+        'plate_number'                         => 'ABC-123',
+        'call_sign'                            => 'TRUCK-42',
+        'fuel_card_number'                     => 'FUEL-42',
+        'vin'                                  => 'VIN42',
+        'vin_data'                             => ['manufacturer' => 'Ford'],
+        'specs'                                => ['doors' => 4],
+        'details'                              => ['liftgate' => true],
+        'status'                               => 'active',
+        'online'                               => true,
+        'slug'                                 => 'truck-42',
+        'financing_status'                     => 'owned',
+        'measurement_system'                   => 'imperial',
+        'odometer'                             => 12000,
+        'odometer_unit'                        => 'mi',
+        'odometer_at_purchase'                 => 100,
+        'fuel_type'                            => 'diesel',
+        'fuel_volume_unit'                     => 'gal',
+        'body_type'                            => 'cargo',
+        'body_sub_type'                        => 'high-roof',
+        'usage_type'                           => 'delivery',
+        'ownership_type'                       => 'owned',
+        'transmission'                         => 'automatic',
+        'engine_number'                        => 'ENG-42',
+        'engine_make'                          => 'Ford',
+        'engine_model'                         => 'EcoBlue',
+        'engine_family'                        => 'inline',
+        'engine_configuration'                 => 'I4',
+        'engine_size'                          => '2.0L',
+        'engine_displacement'                  => '1995cc',
+        'cylinder_arrangement'                 => 'inline',
+        'number_of_cylinders'                  => 4,
+        'horsepower'                           => 170,
+        'horsepower_rpm'                       => 3500,
+        'torque'                               => 390,
+        'torque_rpm'                           => 1750,
+        'fuel_capacity'                        => 25,
+        'payload_capacity'                     => 3500,
+        'towing_capacity'                      => 5000,
+        'seating_capacity'                     => 2,
+        'weight'                               => 6200,
+        'length'                               => 240,
+        'width'                                => 82,
+        'height'                               => 110,
+        'cargo_volume'                         => 487,
+        'passenger_volume'                     => 120,
+        'interior_volume'                      => 607,
+        'ground_clearance'                     => 6,
+        'bed_length'                           => 0,
+        'emission_standard'                    => 'Euro 6',
+        'dpf_equipped'                         => true,
+        'scr_equipped'                         => true,
+        'gvwr'                                 => 9500,
+        'gcwr'                                 => 12000,
+        'estimated_service_life_distance'      => 250000,
+        'estimated_service_life_distance_unit' => 'mi',
+        'estimated_service_life_months'        => 96,
+        'currency'                             => 'USD',
+        'acquisition_cost'                     => 45000,
+        'current_value'                        => 40000,
+        'insurance_value'                      => 42000,
+        'depreciation_rate'                    => 0.15,
+        'loan_amount'                          => 0,
+        'loan_number_of_payments'              => 0,
+        'loan_first_payment'                   => null,
+        'purchased_at'                         => '2026-01-01',
+        'lease_expires_at'                     => null,
+        'deleted_at'                           => null,
+        'updated_at'                           => '2026-07-01 10:00:00',
+        'created_at'                           => '2026-01-01 09:00:00',
+        'location'                             => ['type' => 'Point', 'coordinates' => [103.85, 1.29]],
+        'heading'                              => 180,
+        'altitude'                             => 12,
+        'speed'                                => 45,
+        'telematics'                           => ['provider' => 'safee'],
+        'notes'                                => 'Keep in city route pool.',
+        'meta'                                 => ['pool' => 'city'],
+    ], $overrides));
+}
+
+test('vehicle resource exposes internal identifiers counters and current order metadata', function () {
+    $request = fleetopsVehicleResourceRequest(true);
+    $payload = (new TestFleetOpsVehicleResource(fleetopsVehicleResourceFixture()))->resolve($request);
+
+    expect($payload)->toMatchArray([
+        'id'                      => 42,
+        'uuid'                    => 'vehicle-uuid',
+        'public_id'               => 'vehicle_public',
+        'company_uuid'            => 'company-uuid',
+        'photo_uuid'              => 'photo-uuid',
+        'avatar_value'            => 'avatar-upload-token',
+        'display_name'            => 'Truck 42 Display',
+        'driver_name'             => 'Jane Driver',
+        'vendor_name'             => 'Vendor One',
+        'assigned_orders_count'   => 3,
+        'current_order_reference' => 'order_current',
+        'plate_number'            => 'ABC-123',
+        'vin_data'                => ['manufacturer' => 'Ford'],
+        'specs'                   => ['doors' => 4],
+        'details'                 => ['liftgate' => true],
+        'online'                  => true,
+        'heading'                 => 180,
+        'altitude'                => 12,
+        'speed'                   => 45,
+        'telematics'              => ['provider' => 'safee'],
+        'meta'                    => ['pool' => 'city'],
+    ]);
+});
+
+test('vehicle resource keeps public payload focused on public identifiers', function () {
+    $request = fleetopsVehicleResourceRequest(false);
+    $payload = (new TestFleetOpsVehicleResource(fleetopsVehicleResourceFixture()))->resolve($request);
+
+    expect($payload['id'])->toBe('vehicle_public')
+        ->and($payload)->not->toHaveKeys(['uuid', 'public_id', 'company_uuid', 'photo_uuid', 'avatar_value', 'display_name'])
+        ->and($payload)->toMatchArray([
+            'internal_id'  => 'VEH-42',
+            'photo_url'    => 'https://cdn.test/photo.png',
+            'avatar_url'   => 'https://cdn.test/avatar.png',
+            'name'         => 'Truck 42',
+            'plate_number' => 'ABC-123',
+            'status'       => 'active',
+            'online'       => true,
+            'currency'     => 'USD',
+            'notes'        => 'Keep in city route pool.',
+        ]);
+});
+
+test('vehicle resource webhook payload serializes fleet vehicle details', function () {
+    $payload = (new TestFleetOpsVehicleResource(fleetopsVehicleResourceFixture()))->toWebhookPayload();
+
+    expect($payload)->toMatchArray([
+        'id'                                   => 'vehicle_public',
+        'internal_id'                          => 'VEH-42',
+        'name'                                 => 'Truck 42',
+        'display_name'                         => 'Truck 42 Display',
+        'vin'                                  => 'VIN42',
+        'plate_number'                         => 'ABC-123',
+        'make'                                 => 'Ford',
+        'model'                                => 'Transit',
+        'status'                               => 'active',
+        'online'                               => true,
+        'measurement_system'                   => 'imperial',
+        'fuel_type'                            => 'diesel',
+        'body_type'                            => 'cargo',
+        'engine_number'                        => 'ENG-42',
+        'fuel_capacity'                        => 25,
+        'estimated_service_life_distance'      => 250000,
+        'estimated_service_life_distance_unit' => 'mi',
+        'currency'                             => 'USD',
+        'current_value'                        => 40000,
+        'heading'                              => 180,
+        'altitude'                             => 12,
+        'speed'                                => 45,
+        'telematics'                           => ['provider' => 'safee'],
+        'meta'                                 => ['pool' => 'city'],
+    ]);
+});
+
+test('vehicle without driver resource omits driver relationships and serializes webhook payloads', function () {
+    $resource = new VehicleWithoutDriverResource(fleetopsVehicleResourceFixture());
+    $request  = fleetopsVehicleResourceRequest(true);
+    $payload  = $resource->resolve($request);
+    $webhook  = $resource->toWebhookPayload();
+
+    expect($payload)->toMatchArray([
+        'id'            => 42,
+        'public_id'     => 'vehicle_public',
+        'driver_name'   => 'Jane Driver',
+        'vendor_name'   => 'Vendor One',
+        'plate_number'  => 'ABC-123',
+        'fuel_capacity' => 25,
+        'meta'          => ['pool' => 'city'],
+    ])
+        ->and($payload)->not->toHaveKeys(['driver', 'assigned_orders_count', 'current_order_reference'])
+        ->and($webhook)->toMatchArray([
+            'id'           => 'vehicle_public',
+            'name'         => 'Truck 42',
+            'plate_number' => 'ABC-123',
+            'online'       => true,
+            'currency'     => 'USD',
+            'meta'         => ['pool' => 'city'],
+        ])
+        ->and($webhook)->not->toHaveKey('driver');
+});

package/translations/bg-bg.yaml

@@ -696,6 +696,7 @@ order:
     order-metadata: Метаданни на поръчката
     order-label: Етикет на поръчката
     waypoint-label: Етикет на междинната точка
+    entity-label: Етикет на единицата
     current-eta: Текущо очаквано време на пристигане
     ect: ECT
     current-destination: Текуща дестинация
@@ -712,6 +713,7 @@ order:
     no-driver-assigned-error: Няма назначен шофьор за тази поръчка.
     failed-to-load-order-label: Неуспешно зареждане на етикета на поръчката.
     failed-to-load-waypoint-label: Неуспешно зареждане на етикета на точката.
+    failed-to-load-entity-label: Неуспешно зареждане на етикета на единицата.
     unable-to-add-entity: Не може да се добави нов обект към поръчката.
     assign-driver-success: Шофьорът ({driverName}) е назначен за поръчка {orderId}.
     cancel-title: Сигурни ли сте, че искате да отмените тази поръчка?

package/translations/en-us.yaml

@@ -727,6 +727,7 @@ order:
         order-metadata: Order Metadata
         order-label: Order Label
         waypoint-label: Waypoint Label
+        entity-label: Entity Label
         current-eta: Current ETA
         ect: ECT
         current-destination: Current Destination
@@ -743,6 +744,7 @@ order:
         no-driver-assigned-error: No driver assigned to this order.
         failed-to-load-order-label: Failed to load order label.
         failed-to-load-waypoint-label: Failed to load waypoint label.
+        failed-to-load-entity-label: Failed to load entity label.
         unable-to-add-entity: Unable to add new entity to order.
         assign-driver-success: Driver ({driverName}) has been assigned to order {orderId}.
         cancel-title: Are you sure you wish to cancel this order?

package/translations/es-pa.yaml

@@ -670,6 +670,7 @@ order:
     order-metadata: Metadatos del pedido
     order-label: Etiqueta de pedido
     waypoint-label: Etiqueta de punto de referencia
+    entity-label: Etiqueta de entidad
     current-eta: ETA actual
     ect: TEC
     current-destination: Destino actual
@@ -686,6 +687,7 @@ order:
     no-driver-assigned-error: No hay ningún conductor asignado a este pedido.
     failed-to-load-order-label: No se pudo cargar la etiqueta del pedido.
     failed-to-load-waypoint-label: No se pudo cargar la etiqueta del waypoint.
+    failed-to-load-entity-label: No se pudo cargar la etiqueta de la entidad.
     unable-to-add-entity: No se puede agregar una nueva entidad al pedido.
     assign-driver-success: El conductor ({driverName}) ha sido asignado al pedido {orderId}.
     cancel-title: ¿Está seguro de que desea cancelar este pedido?

package/translations/fr-fr.yaml

@@ -704,6 +704,7 @@ order:
     order-metadata: Métadonnées de la commande
     order-label: Étiquette de la commande
     waypoint-label: Étiquette du point de passage
+    entity-label: Étiquette de l'entité
     current-eta: ETA actuel
     ect: ECT
     current-destination: Destination actuelle
@@ -721,6 +722,7 @@ order:
     failed-to-load-order-label: Échec du chargement de l'étiquette de la commande.
     failed-to-load-waypoint-label: Échec du chargement de l'étiquette du point de
       passage.
+    failed-to-load-entity-label: Échec du chargement de l'étiquette de l'entité.
     unable-to-add-entity: Impossible d'ajouter une nouvelle entité à la commande.
     assign-driver-success: Le conducteur ({driverName}) a été assigné à la commande
       {orderId}.

package/translations/mn-mn.yaml

@@ -692,6 +692,7 @@ order:
     order-metadata: Захиалгын мета өгөгдөл
     order-label: Захиалгын шошго
     waypoint-label: Замын цэгийн шошго
+    entity-label: Объектийн шошго
     current-eta: Одоогийн тооцоолсон хүрэх цаг
     ect: ECT
     current-destination: Одоогийн очих газар
@@ -708,6 +709,7 @@ order:
     no-driver-assigned-error: Энэ захиалгад жолооч томилогдоогүй байна.
     failed-to-load-order-label: Захиалгын шошгыг ачааллахад алдаа гарлаа.
     failed-to-load-waypoint-label: Замын цэгийн шошгыг ачааллахад алдаа гарлаа.
+    failed-to-load-entity-label: Объектийн шошгыг ачааллахад алдаа гарлаа.
     unable-to-add-entity: Захиалгад шинэ объект нэмэх боломжгүй байна.
     assign-driver-success: Жолооч ({driverName}) захиалга {orderId}-д томилогдлоо.
     cancel-title: Та энэ захиалгыг цуцлахдаа итгэлтэй байна уу?

package/translations/pt-br.yaml

@@ -695,6 +695,7 @@ order:
     order-metadata: Metadados do Pedido
     order-label: Etiqueta do Pedido
     waypoint-label: Etiqueta do Ponto de Passagem
+    entity-label: Etiqueta da Entidade
     current-eta: ETA Atual
     ect: ECT
     current-destination: Destino Atual
@@ -711,6 +712,7 @@ order:
     no-driver-assigned-error: Nenhum motorista atribuído a este pedido.
     failed-to-load-order-label: Falha ao carregar o rótulo do pedido.
     failed-to-load-waypoint-label: Falha ao carregar o rótulo do ponto de passagem.
+    failed-to-load-entity-label: Falha ao carregar o rótulo da entidade.
     unable-to-add-entity: Não foi possível adicionar nova entidade ao pedido.
     assign-driver-success: O motorista ({driverName}) foi atribuído ao pedido {orderId}.
     cancel-title: Tem certeza de que deseja cancelar este pedido?

package/translations/ru-ru.yaml

@@ -691,6 +691,7 @@ order:
     order-metadata: Метаданные заказа
     order-label: Этикетка заказа
     waypoint-label: Этикетка промежуточной точки
+    entity-label: Этикетка сущности
     current-eta: Текущее время прибытия
     ect: Ожидаемое время прибытия
     current-destination: Текущее место назначения
@@ -707,6 +708,7 @@ order:
     no-driver-assigned-error: К этому заказу не назначен водитель.
     failed-to-load-order-label: Не удалось загрузить метку заказа.
     failed-to-load-waypoint-label: Не удалось загрузить метку контрольной точки.
+    failed-to-load-entity-label: Не удалось загрузить метку сущности.
     unable-to-add-entity: Невозможно добавить новый объект в заказ.
     assign-driver-success: Водитель ({driverName}) был назначен на заказ {orderId}.
     cancel-title: Вы уверены, что хотите отменить этот заказ?

package/server/tests/DeviceFilterTest.php

@@ -1,44 +0,0 @@
-<?php
-
-test('device filter exposes telematics detail filter contract', function () {
-    $filter     = file_get_contents(dirname(__DIR__) . '/src/Http/Filter/DeviceFilter.php');
-    $model      = file_get_contents(dirname(__DIR__) . '/src/Models/Device.php');
-    $controller = file_get_contents(dirname(__DIR__) . '/src/Http/Controllers/Internal/v1/DeviceController.php');
-
-    expect($model)
-        ->toContain("'vehicle'")
-        ->toContain("'connection_status'")
-        ->toContain("'device_id'")
-        ->toContain("'type'")
-        ->toContain("'serial_number'")
-        ->toContain("'last_online_at'")
-        ->toContain("'updated_at'");
-
-    expect($filter)
-        ->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("wherePublicRelation('attachable_uuid', Vehicle::class, \$vehicle)")
-        ->toContain('public function connectionStatus')
-        ->toContain("'online'")
-        ->toContain("'recently_offline'")
-        ->toContain("'offline'")
-        ->toContain("'long_offline'")
-        ->toContain("'never_connected'")
-        ->toContain('public function lastOnlineAt')
-        ->toContain('public function updatedAt')
-        ->toContain('Utils::dateRange')
-        ->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/LiveControllerViewportTest.php

@@ -1,52 +0,0 @@
-<?php
-
-use Fleetbase\FleetOps\Http\Controllers\Internal\v1\LiveController;
-use Illuminate\Http\Request;
-
-function callLiveControllerMethod(string $method, array $arguments = [])
-{
-    $reflection = new ReflectionMethod(LiveController::class, $method);
-    $reflection->setAccessible(true);
-
-    return $reflection->invokeArgs(new LiveController(), $arguments);
-}
-
-test('live viewport bounds are normalized for stable cache keys', function () {
-    $request = new Request([
-        'bounds' => ['1.234567', '103.876543', '1.345678', '103.987654'],
-    ]);
-
-    expect(callLiveControllerMethod('normalizeLiveBounds', [$request]))
-        ->toBe([1.2346, 103.8765, 1.3457, 103.9877]);
-});
-
-test('invalid live viewport bounds fall back to unbounded queries', function ($bounds) {
-    $request = new Request(['bounds' => $bounds]);
-
-    expect(callLiveControllerMethod('normalizeLiveBounds', [$request]))->toBeNull();
-})->with([
-    'missing coordinate' => [[1, 2, 3]],
-    'non numeric'        => [[1, 'west', 3, 4]],
-    'invalid latitude'   => [[-91, 103, 1, 104]],
-    'invalid longitude'  => [[1, -181, 2, 104]],
-    'inverted latitude'  => [[2, 103, 1, 104]],
-    'inverted longitude' => [[1, 104, 2, 103]],
-]);
-
-test('live viewport limit defaults and clamps', function () {
-    expect(callLiveControllerMethod('normalizeLiveLimit', [new Request()]))->toBe(500)
-        ->and(callLiveControllerMethod('normalizeLiveLimit', [new Request(['limit' => 25])]))->toBe(25)
-        ->and(callLiveControllerMethod('normalizeLiveLimit', [new Request(['limit' => 0])]))->toBe(500)
-        ->and(callLiveControllerMethod('normalizeLiveLimit', [new Request(['limit' => 5000])]))->toBe(1000);
-});
-
-test('live viewport query avoids spatial constructors with fixed srids', function () {
-    $controller = file_get_contents(dirname(__DIR__) . '/src/Http/Controllers/Internal/v1/LiveController.php');
-
-    expect($controller)->toContain('protected function applyLiveLocationGuards')
-        ->and($controller)->toContain('protected function applyLiveViewportBounds')
-        ->and($controller)->toContain('ST_Y(location) BETWEEN ? AND ?')
-        ->and($controller)->toContain('ST_X(location) BETWEEN ? AND ?')
-        ->and($controller)->not->toContain('ST_MakeEnvelope')
-        ->and($controller)->not->toContain('ST_GeomFromText');
-});