@fleetbase/fleetops-engine 0.6.51 → 0.6.53

package/server/src/routes.php

@@ -305,6 +305,8 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                         ],
                     ],
                     function ($router) {
+                        $router->get('search', 'SearchController@search');
+
                         $router->fleetbaseRoutes(
                             'contacts',
                             function ($router, $controller) {
@@ -321,6 +323,12 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                             function ($router, $controller) {
                                 $router->get('statuses', $controller('statuses'));
                                 $router->get('avatars', $controller('avatars'));
+                                $router->get('{id}/assigned-orders', $controller('assignedOrders'));
+                                $router->post('{id}/assign-order', $controller('assignOrder'));
+                                $router->post('{id}/unassign-orders', $controller('unassignOrders'));
+                                $router->post('{id}/unassign-order', $controller('unassignOrder'));
+                                $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'));
@@ -352,6 +360,25 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                                 $router->delete('bulk-delete', $controller('bulkDelete'));
                             }
                         );
+                        $router->fleetbaseRoutes(
+                            'fuel-provider-connections',
+                            function ($router, $controller) {
+                                $router->get('providers', $controller('providers'));
+                                $router->post('providers/{provider}/test-credentials', $controller('testCredentials'));
+                                $router->post('{id}/test-connection', $controller('testConnection'));
+                                $router->post('{id}/sync', $controller('sync'));
+                            }
+                        );
+                        $router->fleetbaseRoutes('fuel-provider-sync-runs');
+                        $router->fleetbaseRoutes(
+                            'fuel-provider-transactions',
+                            function ($router, $controller) {
+                                $router->post('{id}/match-vehicle', $controller('matchVehicle'));
+                                $router->post('{id}/match-order', $controller('matchOrder'));
+                                $router->post('{id}/reprocess', $controller('reprocess'));
+                                $router->post('{id}/review', $controller('review'));
+                            }
+                        );
                         $router->get('issues/{id}/timeline', 'IssueController@timeline');
                         $router->fleetbaseRoutes(
                             'issues',
@@ -459,6 +486,12 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                             function ($router, $controller) {
                                 $router->get('statuses', $controller('statuses'));
                                 $router->get('avatars', $controller('avatars'));
+                                $router->post('{id}/assign-driver', $controller('assignDriver'));
+                                $router->post('{id}/unassign-driver', $controller('unassignDriver'));
+                                $router->get('{id}/assigned-orders', $controller('assignedOrders'));
+                                $router->post('{id}/unassign-orders', $controller('unassignOrders'));
+                                $router->post('{id}/attach-device', $controller('attachDevice'));
+                                $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'));
@@ -482,13 +515,18 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                             }
                         );
                         $router->fleetbaseRoutes('devices');
-                        $router->fleetbaseRoutes('device-events');
+                        $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('telematics', function ($router, $controller) {
                             $router->get('providers', $controller('providers'));
-                            $router->get('devices', $controller('devices'));
-                            $router->post('link-device', $controller('linkDevice'));
-                            $router->post('discover', $controller('discover'));
+                            $router->get('{id}/logs', $controller('logs'));
+                            $router->get('{id}/devices', $controller('devices'));
+                            $router->post('{id}/link-device', $controller('linkDevice'));
+                            $router->post('{id}/discover', $controller('discover'));
                             $router->post('{id}/test-connection', $controller('testConnection'));
                             $router->post('{key}/test-credentials', $controller('testCredentials'));
                         });
@@ -628,12 +666,20 @@ Route::prefix(config('fleetops.api.routing.prefix'))->namespace('Fleetbase\Fleet
                                         $router->get('on-time-delivery', 'AnalyticsController@onTimeDelivery');
                                         $router->get('top-drivers', 'AnalyticsController@topDrivers');
                                         $router->get('fuel-efficiency', 'AnalyticsController@fuelEfficiency');
+                                        $router->get('fuel-providers', 'AnalyticsController@fuelProviders');
                                         $router->get('issues-insights', 'AnalyticsController@issuesInsights');
                                         $router->get('maintenance-overview', 'AnalyticsController@maintenanceOverview');
                                         $router->get('geofence-violations', 'AnalyticsController@geofenceViolations');
                                         $router->get('live-fleet', 'AnalyticsController@liveFleet');
                                     }
                                 );
+                                $router->group(
+                                    ['prefix' => 'hubs'],
+                                    function ($router) {
+                                        $router->get('resources', 'HubController@resources');
+                                        $router->get('maintenance', 'HubController@maintenance');
+                                    }
+                                );
                                 $router->group(
                                     ['prefix' => 'getting-started'],
                                     function ($router) {

package/server/tests/FuelProviderRegistryTest.php

@@ -0,0 +1,416 @@
+<?php
+
+use Fleetbase\FleetOps\Contracts\FuelProvider;
+use Fleetbase\FleetOps\Models\FuelProviderConnection;
+use Fleetbase\FleetOps\Models\FuelProviderTransaction;
+use Fleetbase\FleetOps\Models\Vehicle;
+use Fleetbase\FleetOps\Support\FuelProviders\FuelProviderDescriptor;
+use Fleetbase\FleetOps\Support\FuelProviders\FuelProviderRegistry;
+use Fleetbase\FleetOps\Support\FuelProviders\FuelProviderService;
+use Illuminate\Support\Carbon;
+use Illuminate\Support\Collection;
+
+test('native and extension fuel providers are exposed through the shared registry', function () {
+    $registry = new FuelProviderRegistry();
+
+    expect($registry->has('petroapp'))->toBeTrue();
+
+    if (!$registry->has('test_fuel_provider')) {
+        $registry->register(new FuelProviderDescriptor([
+            'key'             => 'test_fuel_provider',
+            'label'           => 'Test Fuel Provider',
+            'type'            => 'extension',
+            'driver_class'    => TestFuelProvider::class,
+            'description'     => 'Test extension fuel provider.',
+            'category'        => 'Fuel card integration',
+            'icon'            => 'gas-pump',
+            'required_fields' => [
+                [
+                    'name'     => 'api_key',
+                    'label'    => 'API Key',
+                    'type'     => 'password',
+                    'required' => true,
+                ],
+            ],
+            'capabilities'  => ['vehicles', 'transactions', 'stations'],
+            'sync_defaults' => [
+                'window_days'              => 7,
+                'matching_order'           => ['plate_number', 'internal_id', 'vin', 'serial_number', 'call_sign', 'fuel_card_number', 'trip_number'],
+                'auto_create_fuel_reports' => true,
+            ],
+        ]));
+    }
+
+    $providers = (new FuelProviderService($registry))->providers();
+
+    expect($registry->has('test_fuel_provider'))->toBeTrue()
+        ->and($registry->resolve('test_fuel_provider'))->toBeInstanceOf(TestFuelProvider::class)
+        ->and($providers->pluck('key')->all())->toContain('petroapp', 'test_fuel_provider')
+        ->and($providers->firstWhere('key', 'test_fuel_provider')['type'])->toBe('extension')
+        ->and($providers->firstWhere('key', 'test_fuel_provider')['capabilities'])->toBe(['vehicles', 'transactions', 'stations'])
+        ->and($providers->firstWhere('key', 'test_fuel_provider')['category'])->toBe('Fuel card integration')
+        ->and($providers->firstWhere('key', 'test_fuel_provider')['sync_defaults']['window_days'])->toBe(7);
+});
+
+test('fuel provider service records sync runs and review states', function () {
+    session(['company' => '00000000-0000-0000-0000-000000000001']);
+
+    $registry = new FuelProviderRegistry();
+    if (!$registry->has('test_fuel_provider')) {
+        $registry->register(new FuelProviderDescriptor([
+            'key'          => 'test_fuel_provider',
+            'label'        => 'Test Fuel Provider',
+            'type'         => 'extension',
+            'driver_class' => TestFuelProvider::class,
+        ]));
+    }
+
+    $service    = new FuelProviderService($registry);
+    $connection = FuelProviderConnection::create([
+        'company_uuid' => session('company'),
+        'provider'     => 'test_fuel_provider',
+        'name'         => 'Test Fuel',
+        'environment'  => 'production',
+        'status'       => 'configured',
+    ]);
+
+    $syncRun = $service->createSyncRun($connection, Carbon::parse('2026-06-01'), Carbon::parse('2026-06-02'));
+
+    expect($syncRun->provider)->toBe('test_fuel_provider')
+        ->and($syncRun->status)->toBe('queued');
+
+    $transaction = FuelProviderTransaction::create([
+        'company_uuid'                  => session('company'),
+        'fuel_provider_connection_uuid' => $connection->uuid,
+        'provider'                      => 'test_fuel_provider',
+        'provider_transaction_id'       => 'txn-1',
+        'sync_status'                   => 'unmatched',
+    ]);
+
+    $reviewed = $service->reviewTransaction($transaction, 'reviewed');
+
+    expect($reviewed->sync_status)->toBe('reviewed')
+        ->and($reviewed->meta['review_status'])->toBe('reviewed');
+});
+
+test('fuel provider matching defaults to plate before provider or internal identifiers', function () {
+    session(['company' => '00000000-0000-0000-0000-000000000001']);
+
+    $registry = new FuelProviderRegistry();
+    if (!$registry->has('test_fuel_provider')) {
+        $registry->register(new FuelProviderDescriptor([
+            'key'          => 'test_fuel_provider',
+            'label'        => 'Test Fuel Provider',
+            'type'         => 'extension',
+            'driver_class' => TestFuelProvider::class,
+        ]));
+    }
+
+    $service       = new FuelProviderService($registry);
+    $internalMatch = Vehicle::create([
+        'company_uuid'  => session('company'),
+        'public_id'     => 'vehicle_internal_default_priority',
+        'internal_id'   => 'MATCH-001',
+        'plate_number'  => 'INTERNAL-ONLY',
+    ]);
+    $plateMatch = Vehicle::create([
+        'company_uuid'  => session('company'),
+        'public_id'     => 'vehicle_plate_default_priority',
+        'internal_id'   => 'PLATE-ONLY',
+        'plate_number'  => 'MATCH-001',
+    ]);
+    $connection = FuelProviderConnection::create([
+        'company_uuid'  => session('company'),
+        'provider'      => 'test_fuel_provider',
+        'name'          => 'Test Fuel',
+        'environment'   => 'production',
+        'status'        => 'configured',
+        'sync_settings' => [
+            'auto_create_fuel_reports' => false,
+        ],
+    ]);
+
+    $transaction = $service->ingestTransaction($connection, [
+        'provider'                => 'test_fuel_provider',
+        'provider_transaction_id' => 'txn-default-plate-first',
+        'provider_vehicle_id'     => $internalMatch->public_id,
+        'internal_number'         => 'MATCH-001',
+        'plate_number'            => 'MATCH-001',
+    ]);
+
+    expect($transaction->vehicle_uuid)->toBe($plateMatch->uuid);
+});
+
+test('fuel provider matching upgrades old provider-first defaults to production defaults', function () {
+    session(['company' => '00000000-0000-0000-0000-000000000001']);
+
+    $registry = new FuelProviderRegistry();
+    if (!$registry->has('test_fuel_provider')) {
+        $registry->register(new FuelProviderDescriptor([
+            'key'          => 'test_fuel_provider',
+            'label'        => 'Test Fuel Provider',
+            'type'         => 'extension',
+            'driver_class' => TestFuelProvider::class,
+        ]));
+    }
+
+    $service       = new FuelProviderService($registry);
+    $internalMatch = Vehicle::create([
+        'company_uuid'  => session('company'),
+        'public_id'     => 'vehicle_internal_legacy_priority',
+        'internal_id'   => 'MATCH-LEGACY',
+        'plate_number'  => 'INTERNAL-LEGACY',
+    ]);
+    $plateMatch = Vehicle::create([
+        'company_uuid'  => session('company'),
+        'public_id'     => 'vehicle_plate_legacy_priority',
+        'internal_id'   => 'PLATE-LEGACY',
+        'plate_number'  => 'MATCH-LEGACY',
+    ]);
+    $connection = FuelProviderConnection::create([
+        'company_uuid'  => session('company'),
+        'provider'      => 'test_fuel_provider',
+        'name'          => 'Test Fuel',
+        'environment'   => 'production',
+        'status'        => 'configured',
+        'sync_settings' => [
+            'matching_order'           => ['provider_vehicle_id', 'internal_number', 'structure_number', 'plate_number', 'vehicle_card_id', 'trip_number'],
+            'auto_create_fuel_reports' => false,
+        ],
+    ]);
+
+    $transaction = $service->ingestTransaction($connection, [
+        'provider'                => 'test_fuel_provider',
+        'provider_transaction_id' => 'txn-legacy-default-upgrade',
+        'provider_vehicle_id'     => $internalMatch->public_id,
+        'internal_number'         => 'MATCH-LEGACY',
+        'plate_number'            => 'MATCH-LEGACY',
+    ]);
+
+    expect($transaction->vehicle_uuid)->toBe($plateMatch->uuid);
+});
+
+test('fuel provider matching honors configured identifier priority', function () {
+    session(['company' => '00000000-0000-0000-0000-000000000001']);
+
+    $registry = new FuelProviderRegistry();
+    if (!$registry->has('test_fuel_provider')) {
+        $registry->register(new FuelProviderDescriptor([
+            'key'          => 'test_fuel_provider',
+            'label'        => 'Test Fuel Provider',
+            'type'         => 'extension',
+            'driver_class' => TestFuelProvider::class,
+        ]));
+    }
+
+    $service       = new FuelProviderService($registry);
+    $internalMatch = Vehicle::create([
+        'company_uuid'  => session('company'),
+        'public_id'     => 'vehicle_internal_configured_priority',
+        'internal_id'   => 'MATCH-002',
+        'plate_number'  => 'INTERNAL-ONLY-2',
+    ]);
+    $plateMatch = Vehicle::create([
+        'company_uuid'  => session('company'),
+        'public_id'     => 'vehicle_plate_configured_priority',
+        'internal_id'   => 'PLATE-ONLY-2',
+        'plate_number'  => 'MATCH-002',
+    ]);
+    $connection = FuelProviderConnection::create([
+        'company_uuid'  => session('company'),
+        'provider'      => 'test_fuel_provider',
+        'name'          => 'Test Fuel',
+        'environment'   => 'production',
+        'status'        => 'configured',
+        'sync_settings' => [
+            'matching_order'           => ['internal_id', 'plate_number'],
+            'auto_create_fuel_reports' => false,
+        ],
+    ]);
+
+    $internalFirst = $service->ingestTransaction($connection, [
+        'provider'                => 'test_fuel_provider',
+        'provider_transaction_id' => 'txn-internal-first',
+        'internal_number'         => 'MATCH-002',
+        'plate_number'            => 'MATCH-002',
+    ]);
+
+    $connection->sync_settings = [
+        'matching_order'           => ['plate_number', 'internal_id'],
+        'auto_create_fuel_reports' => false,
+    ];
+    $connection->save();
+
+    $plateFirst = $service->ingestTransaction($connection->fresh(), [
+        'provider'                => 'test_fuel_provider',
+        'provider_transaction_id' => 'txn-plate-first',
+        'internal_number'         => 'MATCH-002',
+        'plate_number'            => 'MATCH-002',
+    ]);
+
+    expect($internalFirst->vehicle_uuid)->toBe($internalMatch->uuid)
+        ->and($plateFirst->vehicle_uuid)->toBe($plateMatch->uuid);
+});
+
+test('fuel provider matching resolves production vehicle identity fields', function () {
+    session(['company' => '00000000-0000-0000-0000-000000000001']);
+
+    $registry = new FuelProviderRegistry();
+    if (!$registry->has('test_fuel_provider')) {
+        $registry->register(new FuelProviderDescriptor([
+            'key'          => 'test_fuel_provider',
+            'label'        => 'Test Fuel Provider',
+            'type'         => 'extension',
+            'driver_class' => TestFuelProvider::class,
+        ]));
+    }
+
+    $service  = new FuelProviderService($registry);
+    $vinMatch = Vehicle::create([
+        'company_uuid' => session('company'),
+        'public_id'    => 'vehicle_vin_priority',
+        'vin'          => 'VIN-001',
+    ]);
+    $serialMatch = Vehicle::create([
+        'company_uuid'  => session('company'),
+        'public_id'     => 'vehicle_serial_priority',
+        'serial_number' => 'SERIAL-001',
+    ]);
+    $callSignMatch = Vehicle::create([
+        'company_uuid' => session('company'),
+        'public_id'    => 'vehicle_call_sign_priority',
+        'call_sign'    => 'CALL-001',
+    ]);
+    $fuelCardMatch = Vehicle::create([
+        'company_uuid'     => session('company'),
+        'public_id'        => 'vehicle_fuel_card_priority',
+        'fuel_card_number' => 'CARD-001',
+    ]);
+    $connection = FuelProviderConnection::create([
+        'company_uuid'  => session('company'),
+        'provider'      => 'test_fuel_provider',
+        'name'          => 'Test Fuel',
+        'environment'   => 'production',
+        'status'        => 'configured',
+        'sync_settings' => [
+            'matching_order'           => ['vin', 'serial_number', 'call_sign', 'fuel_card_number'],
+            'auto_create_fuel_reports' => false,
+        ],
+    ]);
+
+    $vinTransaction = $service->ingestTransaction($connection, [
+        'provider'                => 'test_fuel_provider',
+        'provider_transaction_id' => 'txn-vin',
+        'vin'                     => 'VIN 001',
+    ]);
+    $serialTransaction = $service->ingestTransaction($connection, [
+        'provider'                => 'test_fuel_provider',
+        'provider_transaction_id' => 'txn-serial',
+        'serial_number'           => 'SERIAL 001',
+    ]);
+    $callSignTransaction = $service->ingestTransaction($connection, [
+        'provider'                => 'test_fuel_provider',
+        'provider_transaction_id' => 'txn-call-sign',
+        'call_sign'               => 'CALL 001',
+    ]);
+    $fuelCardTransaction = $service->ingestTransaction($connection, [
+        'provider'                => 'test_fuel_provider',
+        'provider_transaction_id' => 'txn-fuel-card',
+        'vehicle_card_id'         => 'CARD 001',
+    ]);
+
+    expect($vinTransaction->vehicle_uuid)->toBe($vinMatch->uuid)
+        ->and($serialTransaction->vehicle_uuid)->toBe($serialMatch->uuid)
+        ->and($callSignTransaction->vehicle_uuid)->toBe($callSignMatch->uuid)
+        ->and($fuelCardTransaction->vehicle_uuid)->toBe($fuelCardMatch->uuid);
+});
+
+test('fuel provider matching leaves transactions unmatched when no selected identifier resolves', function () {
+    session(['company' => '00000000-0000-0000-0000-000000000001']);
+
+    $registry = new FuelProviderRegistry();
+    if (!$registry->has('test_fuel_provider')) {
+        $registry->register(new FuelProviderDescriptor([
+            'key'          => 'test_fuel_provider',
+            'label'        => 'Test Fuel Provider',
+            'type'         => 'extension',
+            'driver_class' => TestFuelProvider::class,
+        ]));
+    }
+
+    $service    = new FuelProviderService($registry);
+    $connection = FuelProviderConnection::create([
+        'company_uuid'  => session('company'),
+        'provider'      => 'test_fuel_provider',
+        'name'          => 'Test Fuel',
+        'environment'   => 'production',
+        'status'        => 'configured',
+        'sync_settings' => [
+            'matching_order'           => ['plate_number', 'internal_id'],
+            'auto_create_fuel_reports' => false,
+        ],
+    ]);
+
+    $transaction = $service->ingestTransaction($connection, [
+        'provider'                => 'test_fuel_provider',
+        'provider_transaction_id' => 'txn-unmatched',
+        'plate_number'            => 'NO-MATCH',
+        'internal_number'         => 'NO-MATCH',
+    ]);
+
+    expect($transaction->vehicle_uuid)->toBeNull()
+        ->and($transaction->sync_status)->toBe('unmatched');
+});
+
+class TestFuelProvider implements FuelProvider
+{
+    public function key(): string
+    {
+        return 'test_fuel_provider';
+    }
+
+    public function name(): string
+    {
+        return 'Test Fuel Provider';
+    }
+
+    public function authenticate(FuelProviderConnection $connection): array
+    {
+        return ['success' => true];
+    }
+
+    public function testConnection(FuelProviderConnection $connection): array
+    {
+        return ['success' => true, 'message' => 'Connected.', 'metadata' => []];
+    }
+
+    public function listVehicles(FuelProviderConnection $connection, array $options = []): Collection
+    {
+        return collect();
+    }
+
+    public function listTransactions(FuelProviderConnection $connection, Carbon $from, Carbon $to, array $options = []): Collection
+    {
+        return collect();
+    }
+
+    public function listStations(FuelProviderConnection $connection, array $options = []): Collection
+    {
+        return collect();
+    }
+
+    public function pushTrip(FuelProviderConnection $connection, array $trip): array
+    {
+        return [];
+    }
+
+    public function syncVehicle(FuelProviderConnection $connection, array $vehicle): array
+    {
+        return [];
+    }
+
+    public function webhookPayloadToTransaction(FuelProviderConnection $connection, array $payload): ?array
+    {
+        return null;
+    }
+}

package/server/tests/HubRoutesTest.php

@@ -0,0 +1,62 @@
+<?php
+
+test('hub routes are registered', function () {
+    $routes = file_get_contents(dirname(__DIR__) . '/src/routes.php');
+
+    expect($routes)
+        ->toContain("['prefix' => 'hubs']")
+        ->toContain("\$router->get('resources', 'HubController@resources');")
+        ->toContain("\$router->get('maintenance', 'HubController@maintenance');");
+});
+
+test('hub controller exposes resources and maintenance contracts', function () {
+    $controller = file_get_contents(dirname(__DIR__) . '/src/Http/Controllers/Internal/v1/HubController.php');
+
+    expect($controller)
+        ->toContain('public function resources(Request $request)')
+        ->toContain('public function maintenance(Request $request)')
+        ->toContain("'kpis'")
+        ->toContain("'actions'")
+        ->toContain("'sections'")
+        ->toContain("'docs'");
+});
+
+test('resources hub action queue includes cross workflow resource actions', function () {
+    $controller = file_get_contents(dirname(__DIR__) . '/src/Http/Controllers/Internal/v1/HubController.php');
+
+    expect($controller)
+        ->toContain("'drivers_without_vehicles'")
+        ->toContain("'vehicles_without_drivers'")
+        ->toContain("'vehicles_without_devices'")
+        ->toContain("'unattached_devices'")
+        ->toContain("'resource_issues'")
+        ->toContain("'overdue_vehicle_schedules'")
+        ->toContain("'open_resource_work_orders'")
+        ->toContain("'low_stock_parts'")
+        ->toContain("'unmatched_fuel_transactions'")
+        ->toContain("'assign_vehicles_to_drivers', 'Assign vehicles to drivers'")
+        ->toContain("'assign_drivers_to_vehicles', 'Assign drivers to vehicles'")
+        ->toContain("'attach_devices_to_vehicles', 'Attach devices to vehicles'")
+        ->toContain("'prepare_vehicle_maintenance', 'Prepare upcoming maintenance'")
+        ->toContain("'close_overdue_work_orders', 'Close overdue work orders'")
+        ->toContain("'replenish_low_stock_parts', 'Replenish low-stock parts'")
+        ->toContain("'review_unmatched_fuel_transactions', 'Review unmatched fuel transactions'")
+        ->toContain("'add_operating_places', 'Add operating places'")
+        ->toContain("'add_service_vendors', 'Add vendors for service work'")
+        ->toContain("'Core resources look ready'");
+});
+
+test('resource action target filters are supported', function () {
+    $deviceFilter  = file_get_contents(dirname(__DIR__) . '/src/Http/Filter/DeviceFilter.php');
+    $driverFilter  = file_get_contents(dirname(__DIR__) . '/src/Http/Filter/DriverFilter.php');
+    $vehicleFilter = file_get_contents(dirname(__DIR__) . '/src/Http/Filter/VehicleFilter.php');
+
+    expect($deviceFilter)
+        ->toContain('public function attachmentState')
+        ->toContain("attachmentState === 'unattached'")
+        ->toContain('public function status')
+        ->toContain('public function telematic');
+
+    expect($driverFilter)->toContain("\$vehicle === 'unassigned'");
+    expect($vehicleFilter)->toContain("\$driverId === 'unassigned'");
+});

package/server/tests/ServiceRateAlgorithmWeightVariablesTest.php

@@ -0,0 +1,44 @@
+<?php
+
+use Fleetbase\FleetOps\Models\Entity;
+use Fleetbase\FleetOps\Models\ServiceRate;
+
+function fleetopsServiceRateAlgorithmQuote(string $algorithm, array $entities): int
+{
+    $serviceRate = new ServiceRate([
+        'rate_calculation_method' => 'algo',
+        'algorithm'               => $algorithm,
+        'base_fee'                => 0,
+        'currency'                => 'USD',
+    ]);
+
+    [$subTotal] = $serviceRate->quoteFromPreliminaryData($entities, ['pickup', 'dropoff']);
+
+    return $subTotal;
+}
+
+test('algorithm rate variables expose summed entity weights in converted units', function () {
+    $entities = [
+        new Entity(['type' => 'parcel', 'weight' => 2, 'weight_unit' => 'kg']),
+        new Entity(['type' => 'parcel', 'weight' => 1, 'weight_unit' => 'lb']),
+    ];
+
+    expect(fleetopsServiceRateAlgorithmQuote('{weight_kg} * 1000', $entities))->toBe(2454)
+        ->and(fleetopsServiceRateAlgorithmQuote('{weight_lb} * 1000', $entities))->toBe(5410)
+        ->and(fleetopsServiceRateAlgorithmQuote('{weight_tonne} * 1000000', $entities))->toBe(2454)
+        ->and(fleetopsServiceRateAlgorithmQuote('{weight_t} * 1000000', $entities))->toBe(2454)
+        ->and(fleetopsServiceRateAlgorithmQuote('{weight} * 1000', $entities))->toBe(2454);
+});
+
+test('algorithm rate weight variables ignore missing or blank entity weights', function () {
+    $entities = [
+        new Entity(['type' => 'parcel', 'weight' => '', 'weight_unit' => 'kg']),
+        new Entity(['type' => 'parcel', 'weight' => null, 'weight_unit' => 'lb']),
+        new Entity(['type' => 'parcel', 'weight' => 500, 'weight_unit' => 'g']),
+        new Entity(['type' => 'parcel']),
+    ];
+
+    expect(fleetopsServiceRateAlgorithmQuote('{weight_kg} * 1000', $entities))->toBe(500)
+        ->and(fleetopsServiceRateAlgorithmQuote('{weight_g}', $entities))->toBe(500)
+        ->and(fleetopsServiceRateAlgorithmQuote('{weight_oz} * 1000', $entities))->toBe(17637);
+});