@fleetbase/fleetops-engine 0.6.57 → 0.6.59

package/server/tests/Unit/Http/Resources/IndexVehicleResourceTest.php

@@ -0,0 +1,194 @@
+<?php
+
+if (!function_exists('Fleetbase\Models\config')) {
+    eval('namespace Fleetbase\Models; function config($key = null, $default = null) { return $key === "fleetbase.connection.db" ? "mysql" : $default; }');
+}
+
+use Fleetbase\FleetOps\Http\Resources\v1\Index\Vehicle as IndexVehicleResource;
+use Fleetbase\FleetOps\Models\Position;
+use Fleetbase\FleetOps\Models\Vehicle;
+use Fleetbase\LaravelMysqlSpatial\Types\Point;
+use Illuminate\Database\ConnectionResolver;
+use Illuminate\Database\Eloquent\Model as EloquentModel;
+use Illuminate\Database\SQLiteConnection;
+use Illuminate\Http\Request;
+use Illuminate\Support\Collection;
+
+class FleetOpsIndexVehicleResourceProbe extends IndexVehicleResource
+{
+    public function compactDevicesForTest(): array
+    {
+        return $this->compactDevices();
+    }
+
+    public function locationCoordinatesForTest(): ?string
+    {
+        return $this->locationCoordinates();
+    }
+
+    public function speedLabelForTest(): string
+    {
+        return $this->speedLabel();
+    }
+
+    public function headingLabelForTest(): string
+    {
+        return $this->headingLabel();
+    }
+
+    public function statusLabelForTest(): ?string
+    {
+        return $this->statusLabel();
+    }
+
+    public function lastKnownPositionForTest(): ?Position
+    {
+        return $this->lastKnownPosition();
+    }
+
+    public function formatCoordinateForTest(float $coordinate): string
+    {
+        return $this->formatCoordinate($coordinate);
+    }
+}
+
+function fleetopsIndexVehicleResourceConnection(): SQLiteConnection
+{
+    $connection = new SQLiteConnection(new PDO('sqlite::memory:'));
+    $connection->statement('create table positions (id integer primary key autoincrement, uuid varchar(64), company_uuid varchar(64) null, subject_uuid varchar(64) null, subject_type varchar(255) null, order_uuid varchar(64) null, coordinates text null, speed integer null, heading integer null, created_at datetime null, updated_at datetime null, deleted_at datetime null)');
+
+    $resolver = new ConnectionResolver([
+        'default' => $connection,
+        'mysql'   => $connection,
+    ]);
+    $resolver->setDefaultConnection('mysql');
+    EloquentModel::setConnectionResolver($resolver);
+
+    return $connection;
+}
+
+function fleetopsIndexVehicleResourceRequest(bool $internal = true): Request
+{
+    $uri     = $internal ? 'api/int/v1/fleet-ops/vehicles/vehicle_public' : 'api/v1/fleet-ops/vehicles/vehicle_public';
+    $request = Request::create('/' . $uri, 'GET');
+    $request->setRouteResolver(fn () => new class($uri) {
+        public function __construct(private string $uri)
+        {
+        }
+
+        public function uri(): string
+        {
+            return $this->uri;
+        }
+    });
+    app()->instance('request', $request);
+
+    return $request;
+}
+
+function fleetopsIndexVehicleModel(array $attributes = []): Vehicle
+{
+    $vehicle = new Vehicle();
+    $vehicle->setRawAttributes(array_merge([
+        'id'               => 101,
+        'uuid'             => 'vehicle-uuid',
+        'public_id'        => 'vehicle_public',
+        'company_uuid'     => 'company-uuid',
+        'vendor_uuid'      => 'vendor-uuid',
+        'photo_uuid'       => null,
+        'internal_id'      => 'VEH-101',
+        'display_name'     => 'Index Van',
+        'driver_name'      => 'Jane Driver',
+        'plate_number'     => 'IDX-101',
+        'serial_number'    => 'SER-101',
+        'fuel_card_number' => 'FUEL-101',
+        'vin'              => 'VIN-101',
+        'make'             => 'Ford',
+        'model'            => 'Transit',
+        'year'             => 2026,
+        'photo_url'        => null,
+        'status'           => 'in_service',
+        'location'         => new Point(1.23456, 103.98765),
+        'heading'          => '180',
+        'altitude'         => '33',
+        'speed'            => '44',
+        'online'           => 1,
+    ], $attributes), true);
+    $vehicle->exists = true;
+    $vehicle->setRelation('driver', null);
+    $vehicle->setRelation('photo', (object) ['url' => 'https://cdn.test/vehicle.png']);
+
+    return $vehicle;
+}
+
+test('index vehicle resource helper methods resolve devices and position labels', function () {
+    fleetopsIndexVehicleResourceConnection();
+    session(['company' => 'company-uuid']);
+
+    $vehicle  = fleetopsIndexVehicleModel();
+    $position = new Position();
+    $position->setRawAttributes([
+        'uuid'    => 'position-uuid',
+        'speed'   => 67,
+        'heading' => 225,
+    ], true);
+    $vehicle->setRelation('last_known_position', $position);
+    $vehicle->setRelation('devices', new Collection([
+        (object) [
+            'uuid'          => 'device-uuid',
+            'public_id'     => 'device_public',
+            'name'          => 'Tracker',
+            'display_name'  => 'Tracker One',
+            'device_id'     => 'HW-1',
+            'serial_number' => 'SER-DEVICE',
+            'imei'          => 'IMEI-1',
+            'provider'      => 'samsara',
+            'status'        => 'online',
+        ],
+    ]));
+
+    $resource = new FleetOpsIndexVehicleResourceProbe($vehicle);
+    fleetopsIndexVehicleResourceRequest(true);
+
+    expect($resource->compactDevicesForTest())->toBe([
+        [
+            'id'            => 'device-uuid',
+            'uuid'          => 'device-uuid',
+            'public_id'     => 'device_public',
+            'name'          => 'Tracker',
+            'display_name'  => 'Tracker One',
+            'device_id'     => 'HW-1',
+            'serial_number' => 'SER-DEVICE',
+            'imei'          => 'IMEI-1',
+            'provider'      => 'samsara',
+            'status'        => 'online',
+        ],
+    ])
+        ->and($resource->locationCoordinatesForTest())->toBe('1.2346 103.9877')
+        ->and($resource->speedLabelForTest())->toBe('67 km/h')
+        ->and($resource->headingLabelForTest())->toBe('225 deg')
+        ->and($resource->statusLabelForTest())->toBe('In Service')
+        ->and($resource->formatCoordinateForTest(1.23456))->toBe('1.2346')
+        ->and($resource->lastKnownPositionForTest()?->uuid)->toBe('position-uuid');
+});
+
+test('index vehicle resource falls back to vehicle order labels and public identity', function () {
+    fleetopsIndexVehicleResourceConnection();
+    session(['company' => 'company-uuid']);
+
+    $vehicle = fleetopsIndexVehicleModel([
+        'location' => null,
+        'speed'    => 'slow',
+        'heading'  => null,
+        'status'   => null,
+    ]);
+    $vehicle->setRelation('last_known_position', null);
+    $resource = new FleetOpsIndexVehicleResourceProbe($vehicle);
+    fleetopsIndexVehicleResourceRequest(false);
+
+    expect($resource->lastKnownPositionForTest())->toBeNull()
+        ->and($resource->locationCoordinatesForTest())->toBe('0 0')
+        ->and($resource->speedLabelForTest())->toBe('-')
+        ->and($resource->headingLabelForTest())->toBe('-')
+        ->and($resource->statusLabelForTest())->toBeNull();
+});

package/server/tests/Unit/Http/Resources/MaintenanceResourcesTest.php

@@ -0,0 +1,182 @@
+<?php
+
+use Fleetbase\FleetOps\Http\Resources\v1\Maintenance as MaintenanceResource;
+use Fleetbase\FleetOps\Http\Resources\v1\MaintenanceSchedule as MaintenanceScheduleResource;
+use Fleetbase\FleetOps\Models\Maintenance;
+use Fleetbase\FleetOps\Models\MaintenanceSchedule;
+use Fleetbase\FleetOps\Models\Vehicle;
+use Illuminate\Database\ConnectionResolver;
+use Illuminate\Database\Eloquent\Model as EloquentModel;
+use Illuminate\Database\SQLiteConnection;
+use Illuminate\Http\Request;
+
+/**
+ * Covers the Maintenance and MaintenanceSchedule API resources: loaded
+ * polymorphic relation serialization, the Ember maintenance-subject and
+ * facilitator type injections with empty passthroughs, and the morph
+ * transformer fallbacks.
+ */
+function fleetopsMaintenanceResourcesBoot(): void
+{
+    $connection = new SQLiteConnection(new PDO('sqlite::memory:'));
+    $resolver   = new ConnectionResolver(['default' => $connection, 'mysql' => $connection]);
+    $resolver->setDefaultConnection('mysql');
+    EloquentModel::setConnectionResolver($resolver);
+    app()->instance('db', new class($connection) {
+        public function __construct(public SQLiteConnection $c)
+        {
+        }
+
+        public function connection($name = null): SQLiteConnection
+        {
+            return $this->c;
+        }
+
+        public function __call($method, $arguments)
+        {
+            return $this->c->{$method}(...$arguments);
+        }
+    });
+    Illuminate\Support\Facades\DB::clearResolvedInstance('db');
+    app()->instance('request', new Request());
+
+    $schema = $connection->getSchemaBuilder();
+    foreach ([
+        'files'               => ['uuid', 'public_id', 'company_uuid', 'type', 'path', 'disk'],
+        'custom_field_values' => ['uuid', 'subject_uuid', 'subject_type', 'custom_field_uuid', 'value', 'value_type'],
+        'drivers'             => ['uuid', 'public_id', 'company_uuid', 'user_uuid', 'vehicle_uuid', 'status'],
+        'users'               => ['uuid', 'public_id', 'company_uuid', 'name'],
+        'devices'             => ['uuid', 'public_id', 'company_uuid', 'attachable_uuid', 'attachable_type', 'device_id', 'status'],
+        'orders'              => ['uuid', 'public_id', 'company_uuid', 'vehicle_assigned_uuid', 'driver_assigned_uuid', 'status'],
+        'vehicle_devices'     => ['uuid', 'vehicle_uuid', 'device_uuid'],
+        'equipment'           => ['uuid', 'public_id', 'company_uuid', 'name', 'status'],
+        // Serializing a loaded Vendor assignee eager-loads its owned places and
+        // its personnel; a loaded Contact performer pulls in vehicles.
+        'places'              => ['uuid', 'public_id', 'company_uuid', 'owner_uuid', 'owner_type', 'name'],
+        'contacts'            => ['uuid', 'public_id', 'company_uuid', 'user_uuid', 'name', 'type'],
+        'vendor_personnels'   => ['uuid', 'vendor_uuid', 'contact_uuid'],
+        'vehicles'            => ['uuid', 'public_id', 'company_uuid', 'plate_number', 'year', 'make', 'model'],
+    ] as $table => $columns) {
+        $schema->create($table, function ($blueprint) use ($columns) {
+            $blueprint->increments('id');
+            foreach ($columns as $column) {
+                $blueprint->string($column)->nullable();
+            }
+            $blueprint->timestamps();
+            $blueprint->timestamp('deleted_at')->nullable();
+        });
+    }
+}
+
+test('maintenance schedule type injections derive subject and facilitator slugs', function () {
+    fleetopsMaintenanceResourcesBoot();
+
+    $schedule = new MaintenanceSchedule();
+    $schedule->setRawAttributes([
+        'uuid'                  => 'ms-1',
+        'public_id'             => 'maintenance_schedule_test',
+        'subject_type'          => Vehicle::class,
+        'default_assignee_type' => Fleetbase\FleetOps\Models\Vendor::class,
+    ], true);
+
+    $resource = new MaintenanceScheduleResource($schedule);
+
+    $setSubjectType = new ReflectionMethod(MaintenanceScheduleResource::class, 'setSubjectType');
+    $setSubjectType->setAccessible(true);
+    $subject = $setSubjectType->invoke($resource, ['uuid' => 'vehicle-1', 'name' => 'Truck']);
+    expect($subject['type'])->toBe('maintenance-subject-vehicle')
+        ->and($setSubjectType->invoke($resource, null))->toBeNull();
+
+    $setAssigneeType = new ReflectionMethod(MaintenanceScheduleResource::class, 'setAssigneeType');
+    $setAssigneeType->setAccessible(true);
+    $assignee = $setAssigneeType->invoke($resource, ['uuid' => 'vendor-1', 'name' => 'Shop']);
+    expect($assignee['facilitator_type'])->toBe('facilitator-vendor')
+        ->and($setAssigneeType->invoke($resource, []))->toBe([]);
+
+    $transform = new ReflectionMethod(MaintenanceScheduleResource::class, 'transformMorphResource');
+    $transform->setAccessible(true);
+    expect($transform->invoke($resource, null))->toBeNull();
+
+    $plain = new class extends EloquentModel {
+        protected $table = 'plain_models';
+    };
+    $plain->setRawAttributes(['uuid' => 'plain-1', 'name' => 'Plain'], true);
+    expect($transform->invoke($resource, $plain)['uuid'])->toBe('plain-1');
+});
+
+test('maintenance type injections derive maintainable and performer slugs', function () {
+    fleetopsMaintenanceResourcesBoot();
+
+    $maintenance = new Maintenance();
+    $maintenance->setRawAttributes([
+        'uuid'              => 'mnt-1',
+        'public_id'         => 'maintenance_test',
+        'maintainable_type' => Vehicle::class,
+        'performed_by_type' => Fleetbase\FleetOps\Models\Contact::class,
+    ], true);
+
+    $resource = new MaintenanceResource($maintenance);
+
+    $setMaintainableType = new ReflectionMethod(MaintenanceResource::class, 'setMaintainableType');
+    $setMaintainableType->setAccessible(true);
+    $maintainable = $setMaintainableType->invoke($resource, ['uuid' => 'vehicle-1', 'name' => 'Truck']);
+    expect($maintainable['type'])->toContain('vehicle')
+        ->and($setMaintainableType->invoke($resource, null))->toBeNull();
+
+    $setPerformedByType = new ReflectionMethod(MaintenanceResource::class, 'setPerformedByType');
+    $setPerformedByType->setAccessible(true);
+    $performer = $setPerformedByType->invoke($resource, ['uuid' => 'contact-1', 'name' => 'Mechanic']);
+    expect($performer)->toBeArray()
+        ->and($setPerformedByType->invoke($resource, []))->toBe([]);
+
+    $transform = new ReflectionMethod(MaintenanceResource::class, 'transformMorphResource');
+    $transform->setAccessible(true);
+    expect($transform->invoke($resource, null))->toBeNull();
+
+    $plain = new class extends EloquentModel {
+        protected $table = 'plain_models';
+    };
+    $plain->setRawAttributes(['uuid' => 'plain-2', 'name' => 'Plain'], true);
+    expect($transform->invoke($resource, $plain)['uuid'])->toBe('plain-2');
+});
+
+test('loaded polymorphic relations serialize through the when loaded callbacks', function () {
+    fleetopsMaintenanceResourcesBoot();
+
+    $vehicle = new Vehicle();
+    $vehicle->setRawAttributes(['uuid' => 'vehicle-1', 'public_id' => 'vehicle_test', 'name' => 'Truck'], true);
+
+    $vendor = new Fleetbase\FleetOps\Models\Vendor();
+    $vendor->setRawAttributes(['uuid' => 'vendor-1', 'public_id' => 'vendor_test', 'name' => 'Shop'], true);
+
+    $contact = new Fleetbase\FleetOps\Models\Contact();
+    $contact->setRawAttributes(['uuid' => 'contact-1', 'public_id' => 'contact_test', 'name' => 'Mechanic'], true);
+
+    $schedule = new MaintenanceSchedule();
+    $schedule->setRawAttributes([
+        'uuid'                  => 'ms-1',
+        'public_id'             => 'maintenance_schedule_test',
+        'subject_type'          => Vehicle::class,
+        'default_assignee_type' => Fleetbase\FleetOps\Models\Vendor::class,
+    ], true);
+    $schedule->setRelation('subject', $vehicle);
+    $schedule->setRelation('defaultAssignee', $vendor);
+
+    $payload = (new MaintenanceScheduleResource($schedule))->toArray(new Request());
+    expect($payload['subject']['type'])->toBe('maintenance-subject-vehicle')
+        ->and($payload['default_assignee']['facilitator_type'])->toBe('facilitator-vendor');
+
+    $maintenance = new Maintenance();
+    $maintenance->setRawAttributes([
+        'uuid'              => 'mnt-1',
+        'public_id'         => 'maintenance_test',
+        'maintainable_type' => Vehicle::class,
+        'performed_by_type' => Fleetbase\FleetOps\Models\Contact::class,
+    ], true);
+    $maintenance->setRelation('maintainable', $vehicle);
+    $maintenance->setRelation('performedBy', $contact);
+
+    $maintenancePayload = (new MaintenanceResource($maintenance))->toArray(new Request());
+    expect($maintenancePayload['maintainable'])->toBeArray()
+        ->and($maintenancePayload['performed_by'])->toBeArray();
+});

package/server/tests/Unit/Http/Resources/OrderAndDriverResourceTest.php

@@ -0,0 +1,121 @@
+<?php
+
+if (!function_exists('Fleetbase\Support\session')) {
+    eval('namespace Fleetbase\Support; function session($key = null, $default = null) { if ($key === null) { return new class { public function has($k) { return \session($k) !== null; } public function get($k, $d = null) { return \session($k, $d); } }; } return \session($key, $default); }');
+}
+
+use Fleetbase\FleetOps\Http\Resources\v1\Driver as DriverResource;
+use Fleetbase\FleetOps\Http\Resources\v1\Order as OrderResource;
+use Fleetbase\FleetOps\Models\Contact;
+use Fleetbase\FleetOps\Models\Driver;
+use Fleetbase\FleetOps\Models\Order;
+use Illuminate\Database\ConnectionResolver;
+use Illuminate\Database\Eloquent\Model as EloquentModel;
+use Illuminate\Database\SQLiteConnection;
+use Illuminate\Http\Request;
+
+/**
+ * Covers the v1 Order and Driver resource transformation seams: morph
+ * resource resolution with the customer user stripped, and the driver
+ * order-count, current-order reference and jobs collection helpers.
+ */
+class FleetOpsOrderResourceProbe extends OrderResource
+{
+    public function callHelper(string $method, ...$arguments): mixed
+    {
+        return $this->{$method}(...$arguments);
+    }
+}
+
+class FleetOpsDriverResourceProbe extends DriverResource
+{
+    public function callHelper(string $method, ...$arguments): mixed
+    {
+        return $this->{$method}(...$arguments);
+    }
+}
+
+function fleetopsResourceBoot(): SQLiteConnection
+{
+    $connection = new SQLiteConnection(new PDO('sqlite::memory:'));
+    $resolver   = new ConnectionResolver(['default' => $connection, 'mysql' => $connection]);
+    $resolver->setDefaultConnection('mysql');
+    EloquentModel::setConnectionResolver($resolver);
+    app()->instance('db', new class($connection) {
+        public function __construct(public SQLiteConnection $c)
+        {
+        }
+
+        public function connection($name = null): SQLiteConnection
+        {
+            return $this->c;
+        }
+
+        public function __call($method, $arguments)
+        {
+            return $this->c->{$method}(...$arguments);
+        }
+    });
+    Illuminate\Support\Facades\DB::clearResolvedInstance('db');
+
+    $schema = $connection->getSchemaBuilder();
+    $tables = [
+        'orders'              => ['uuid', 'public_id', 'company_uuid', 'payload_uuid', 'customer_uuid', 'customer_type', 'tracking_number_uuid', 'driver_assigned_uuid', 'status', 'type', 'tracking', 'meta'],
+        'contacts'            => ['uuid', 'public_id', 'company_uuid', 'user_uuid', 'name', 'email', 'type'],
+        'drivers'             => ['uuid', 'public_id', 'company_uuid', 'user_uuid', 'current_job_uuid', 'status'],
+        'users'               => ['uuid', 'public_id', 'company_uuid', 'name', 'type'],
+        'places'              => ['uuid', 'public_id', 'company_uuid', 'owner_uuid', 'owner_type', 'name', 'location'],
+        'vehicles'            => ['uuid', 'public_id', 'company_uuid', 'driver_uuid', 'name'],
+        'payloads'            => ['uuid', 'public_id', 'company_uuid', 'pickup_uuid', 'dropoff_uuid', 'meta'],
+        'tracking_numbers'    => ['uuid', 'public_id', 'company_uuid', 'tracking_number', 'owner_uuid', '_key'],
+        'custom_fields'       => ['uuid', 'public_id', 'company_uuid', 'subject_uuid', 'subject_type', 'name', 'label'],
+        'custom_field_values' => ['uuid', 'public_id', 'company_uuid', 'custom_field_uuid', 'subject_uuid', 'subject_type', 'value', 'value_type'],
+    ];
+    foreach ($tables as $table => $columns) {
+        $schema->create($table, function ($blueprint) use ($columns) {
+            $blueprint->increments('id');
+            foreach ($columns as $column) {
+                $blueprint->string($column)->nullable();
+            }
+            $blueprint->timestamps();
+            $blueprint->timestamp('deleted_at')->nullable();
+        });
+    }
+
+    app()->instance('request', Request::create('/v1/orders', 'GET'));
+    session(['company' => 'company-1']);
+
+    return $connection;
+}
+
+test('order resources transform morph customers without nested users', function () {
+    $connection = fleetopsResourceBoot();
+    $connection->table('contacts')->insert(['uuid' => 'contact-res-1', 'public_id' => 'contact_resone1', 'company_uuid' => 'company-1', 'name' => 'Resource Customer', 'type' => 'customer']);
+
+    $contact = Contact::where('uuid', 'contact-res-1')->first();
+    $probe   = new FleetOpsOrderResourceProbe(new Order());
+
+    // Null morphs return null, models resolve through their http resources
+    expect($probe->callHelper('transformMorphResource', null))->toBeNull();
+
+    $resolved = $probe->callHelper('transformOrderCustomerResource', $contact);
+    expect($resolved)->toBeArray()
+        ->and($resolved)->not->toHaveKey('user');
+});
+
+test('driver resources count orders and reference current jobs', function () {
+    $connection = fleetopsResourceBoot();
+    $connection->table('users')->insert(['uuid' => 'user-res-1', 'company_uuid' => 'company-1', 'name' => 'Resource Driver']);
+    $connection->table('drivers')->insert(['uuid' => 'driver-res-1', 'public_id' => 'driver_resone1', 'company_uuid' => 'company-1', 'user_uuid' => 'user-res-1', 'current_job_uuid' => 'order-res-1']);
+    $connection->table('orders')->insert([
+        ['uuid' => 'order-res-1', 'public_id' => 'order_resone1', 'company_uuid' => 'company-1', 'driver_assigned_uuid' => 'driver-res-1', 'status' => 'created', 'tracking' => null],
+        ['uuid' => 'order-res-2', 'public_id' => 'order_restwo2', 'company_uuid' => 'company-1', 'driver_assigned_uuid' => 'driver-res-1', 'status' => 'created', 'tracking' => null],
+    ]);
+
+    $driver = Driver::where('uuid', 'driver-res-1')->first();
+    $probe  = new FleetOpsDriverResourceProbe($driver);
+
+    expect($probe->callHelper('assignedOrdersCount'))->toBe(2)
+        ->and($probe->callHelper('currentOrderReference'))->toBe('order_resone1')
+        ->and($probe->callHelper('getJobs'))->not->toBeNull();
+});

package/server/tests/Unit/Http/Resources/OrderConfigResourceTest.php

@@ -0,0 +1,47 @@
+<?php
+
+if (!function_exists('Fleetbase\Traits\config')) {
+    eval('namespace Fleetbase\Traits; function config($key = null, $default = null) { return $key === "api.cache.enabled" ? false : $default; }');
+}
+
+use Fleetbase\FleetOps\Http\Resources\v1\OrderConfig as OrderConfigResource;
+use Fleetbase\FleetOps\Models\OrderConfig;
+use Illuminate\Http\Request;
+
+class FleetOpsOrderConfigResourceRequestState
+{
+    public static ?Request $request = null;
+}
+
+if (!class_exists('FleetOpsSupportRequestState')) {
+    class FleetOpsSupportRequestState
+    {
+        public static ?Request $request = null;
+    }
+}
+
+if (!function_exists('Fleetbase\Support\request')) {
+    eval('namespace Fleetbase\Support; function request($key = null, $default = null) { return \FleetOpsSupportRequestState::$request; }');
+}
+
+test('order config resource projects empty and invalid flow as an empty list', function () {
+    $request                                          = Request::create('/v1/fleet-ops/order-configs/order_config_public', 'GET');
+    FleetOpsOrderConfigResourceRequestState::$request = $request;
+    FleetOpsSupportRequestState::$request             = $request;
+
+    $config = new OrderConfig();
+    $config->setRawAttributes([
+        'id'          => 7,
+        'uuid'        => 'order-config-uuid',
+        'public_id'   => 'order_config_public',
+        'key'         => 'transport',
+        'name'        => 'Transport',
+        'description' => 'Default transport flow.',
+        'flow'        => null,
+    ], true);
+
+    $payload = (new OrderConfigResource($config))->resolve($request);
+
+    expect($payload['id'])->toBe('order_config_public')
+        ->and($payload['flow'])->toBe([]);
+});

package/server/tests/Unit/Http/Resources/PayloadResourceTest.php

@@ -0,0 +1,111 @@
+<?php
+
+use Fleetbase\FleetOps\Http\Resources\v1\Payload as PayloadResource;
+use Fleetbase\FleetOps\Models\Payload;
+use Fleetbase\FleetOps\Models\Place;
+use Fleetbase\FleetOps\Models\Waypoint;
+use Illuminate\Database\ConnectionResolver;
+use Illuminate\Database\Eloquent\Model as EloquentModel;
+use Illuminate\Database\SQLiteConnection;
+use Illuminate\Http\Request;
+
+/**
+ * Covers the Payload API resource: full array serialization with and without
+ * route ETAs (the tracker is registered as an Expandable expansion), the
+ * private place/waypoint builders, and the webhook payload projection.
+ */
+function fleetopsPayloadResourceBoot(): void
+{
+    $connection = new SQLiteConnection(new PDO('sqlite::memory:'));
+    $resolver   = new ConnectionResolver(['default' => $connection, 'mysql' => $connection]);
+    $resolver->setDefaultConnection('mysql');
+    EloquentModel::setConnectionResolver($resolver);
+
+    Payload::expand('tracker', function () {
+        return new class {
+            public function getWaypointETA($waypoint): int
+            {
+                return 420;
+            }
+        };
+    });
+}
+
+function fleetopsPayloadResourcePayload(): Payload
+{
+    $payload = new Payload();
+    $payload->setRawAttributes([
+        'uuid'         => 'payload-1',
+        'public_id'    => 'payload_test',
+        'cod_amount'   => '25.00',
+        'cod_currency' => 'SGD',
+    ], true);
+    $payload->exists = true;
+
+    $pickup = new Place();
+    $pickup->setRawAttributes(['uuid' => 'place-1', 'public_id' => 'place_pickup', 'name' => 'Pickup'], true);
+    $dropoff = new Place();
+    $dropoff->setRawAttributes(['uuid' => 'place-2', 'public_id' => 'place_dropoff', 'name' => 'Dropoff'], true);
+    $waypoint = new Waypoint();
+    $waypoint->setRawAttributes(['uuid' => 'wp-1', 'public_id' => 'waypoint_1', 'place_uuid' => 'place-1'], true);
+
+    $payload->setRelation('pickup', $pickup);
+    $payload->setRelation('dropoff', $dropoff);
+    $payload->setRelation('return', null);
+    $payload->setRelation('waypoints', collect([$waypoint]));
+    $payload->setRelation('entities', collect([]));
+
+    return $payload;
+}
+
+test('payload resource serializes with route etas from the tracker expansion', function () {
+    fleetopsPayloadResourceBoot();
+
+    $resource = new PayloadResource(fleetopsPayloadResourcePayload());
+    $payload  = $resource->toArray(new Request(['with_route_eta' => 1]));
+
+    expect($payload['cod_amount'])->toBe('25.00')
+        ->and($payload['cod_currency'])->toBe('SGD')
+        ->and(count($payload['waypoints']))->toBe(1)
+        ->and($payload['waypoints'][0]->eta)->toBe(420)
+        // toArray only routes the ETA flag into waypoints; pickup/dropoff
+        // are serialized without ETAs.
+        ->and($payload['pickup']->eta)->toBeNull();
+});
+
+test('payload place and waypoint builders skip etas when not requested', function () {
+    fleetopsPayloadResourceBoot();
+
+    $model    = fleetopsPayloadResourcePayload();
+    $resource = new PayloadResource($model);
+
+    $getPlace = new ReflectionMethod(PayloadResource::class, 'getPlace');
+    $getPlace->setAccessible(true);
+    $place = $getPlace->invoke($resource, $model->pickup, false);
+    expect($place)->toBeInstanceOf(Fleetbase\FleetOps\Http\Resources\v1\Place::class)
+        ->and($model->pickup->eta)->toBeNull();
+
+    // Requesting the ETA resolves it through the tracker expansion
+    $getPlace->invoke($resource, $model->pickup, true);
+    expect($model->pickup->eta)->toBe(420);
+
+    $getWaypoints = new ReflectionMethod(PayloadResource::class, 'getWaypoints');
+    $getWaypoints->setAccessible(true);
+    $waypoints = $getWaypoints->invoke($resource, false);
+    expect($waypoints)->toHaveCount(1)
+        ->and($waypoints->first()->payload_uuid)->toBe('payload-1');
+
+    // Non-collection waypoints fall back to an empty collection
+    $model->setRelation('waypoints', null);
+    expect($getWaypoints->invoke($resource, false))->toHaveCount(0);
+});
+
+test('payload webhook projection exposes public ids and child places', function () {
+    fleetopsPayloadResourceBoot();
+
+    $hook = (new PayloadResource(fleetopsPayloadResourcePayload()))->toWebhookPayload();
+
+    expect($hook['id'])->toBe('payload_test')
+        ->and($hook)->toHaveKeys(['pickup', 'dropoff', 'return', 'waypoints', 'entities', 'cod_amount', 'meta'])
+        ->and($hook['cod_amount'])->toBe('25.00');
+});