@fleetbase/fleetops-engine 0.6.58 → 0.6.59

package/server/tests/Feature/Http/Api/ServiceQuoteControllerQueryTest.php

@@ -0,0 +1,405 @@
+<?php
+
+use Fleetbase\FleetOps\Http\Controllers\Api\v1\ServiceQuoteController;
+use Fleetbase\FleetOps\Http\Requests\QueryServiceQuotesRequest;
+use Fleetbase\FleetOps\Http\Resources\v1\ServiceQuote as ServiceQuoteResource;
+use Fleetbase\FleetOps\Models\Payload;
+use Fleetbase\FleetOps\Models\Place;
+use Fleetbase\FleetOps\Models\ServiceQuote;
+use Fleetbase\FleetOps\Models\ServiceQuoteItem;
+use Fleetbase\FleetOps\Models\ServiceRate;
+use Fleetbase\LaravelMysqlSpatial\Types\Point;
+use Illuminate\Database\ConnectionResolver;
+use Illuminate\Database\Eloquent\Model as EloquentModel;
+use Illuminate\Database\SQLiteConnection;
+use Illuminate\Http\JsonResponse;
+
+/**
+ * Covers the API ServiceQuoteController query() endpoint branches and the real
+ * bodies of its protected helper methods. The existing contracts test covers
+ * queryFromPreliminary() with an all-overriding probe, which leaves query()
+ * and every real helper implementation unexecuted.
+ */
+class FleetOpsApiServiceQuoteQueryProbe extends ServiceQuoteController
+{
+    public ?ServiceRate $serviceRate = null;
+    public iterable $servicableRates = [];
+    public array $preliminaryCalls   = [];
+    public array $createdQuotes      = [];
+    public array $createdItems       = [];
+
+    public function callProtected(string $method, array $arguments = []): mixed
+    {
+        $reflection = new ReflectionMethod(ServiceQuoteController::class, $method);
+        $reflection->setAccessible(true);
+
+        return $reflection->invoke($this, ...$arguments);
+    }
+
+    public function queryFromPreliminary(QueryServiceQuotesRequest $request)
+    {
+        $this->preliminaryCalls[] = $request->input('payload');
+
+        return 'preliminary-fallback';
+    }
+
+    protected function generateServiceQuoteRequestId(): string
+    {
+        return 'request_test';
+    }
+
+    protected function findServiceRateForQuote(string $service, ?string $currency): ?ServiceRate
+    {
+        return $this->serviceRate;
+    }
+
+    protected function getServicableServiceRates(iterable $waypoints, ?string $serviceType, mixed $currency, callable $callback): iterable
+    {
+        $callback(new FleetOpsApiServiceQuoteQueryFakeQuery());
+
+        return $this->servicableRates;
+    }
+
+    protected function createServiceQuote(array $attributes): ServiceQuote
+    {
+        $this->createdQuotes[] = $attributes;
+        $quote                 = new FleetOpsApiServiceQuoteQuoteFake();
+        $quote->setRawAttributes(array_merge(['uuid' => 'quote-' . count($this->createdQuotes)], $attributes), true);
+
+        return $quote;
+    }
+
+    protected function createServiceQuoteItem(array $attributes): ServiceQuoteItem
+    {
+        $this->createdItems[] = $attributes;
+        $item                 = new ServiceQuoteItem();
+        $item->setRawAttributes($attributes, true);
+
+        return $item;
+    }
+}
+
+class FleetOpsApiServiceQuoteQueryFakeQuery
+{
+    public array $wheres = [];
+
+    public function where(...$arguments): self
+    {
+        $this->wheres[] = $arguments;
+
+        return $this;
+    }
+}
+
+class FleetOpsApiServiceQuoteQuoteFake extends ServiceQuote
+{
+    protected $guarded = [];
+    public $exists     = true;
+}
+
+class FleetOpsApiServiceQuoteQueryRateFake extends ServiceRate
+{
+    protected $guarded = [];
+    public $exists     = true;
+
+    public function quote($payload = null, array $options = [])
+    {
+        return [4900, collect([
+            ['amount' => 4900, 'currency' => 'USD', 'details' => 'Base fee', 'code' => 'BASE'],
+        ])];
+    }
+}
+
+class FleetOpsApiServiceQuoteQueryPayloadFake extends Payload
+{
+    protected $guarded = [];
+    public $exists     = true;
+
+    public function getAllStops(): Illuminate\Support\Collection
+    {
+        $place = new Place();
+        $place->setRawAttributes(['uuid' => 'stop-1', 'location' => new Point(1.0, 2.0)], true);
+
+        return collect([$place]);
+    }
+}
+
+function fleetopsApiServiceQuoteQueryBoot(): 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);
+        }
+    });
+
+    $schema = $connection->getSchemaBuilder();
+    app()->instance('db.schema', $schema);
+    $schema->create('service_quotes', function ($table) {
+        $table->increments('id');
+        $table->string('uuid')->nullable();
+        $table->string('public_id')->nullable();
+        $table->string('request_id')->nullable();
+        $table->string('company_uuid')->nullable();
+        $table->string('service_rate_uuid')->nullable();
+        $table->integer('amount')->nullable();
+        $table->string('currency')->nullable();
+        $table->text('meta')->nullable();
+        $table->timestamp('expired_at')->nullable();
+        $table->timestamps();
+        $table->timestamp('deleted_at')->nullable();
+    });
+    $schema->create('service_quote_items', function ($table) {
+        $table->increments('id');
+        $table->string('uuid')->nullable();
+        $table->string('service_quote_uuid')->nullable();
+        $table->integer('amount')->nullable();
+        $table->string('currency')->nullable();
+        $table->string('details')->nullable();
+        $table->string('code')->nullable();
+        $table->timestamps();
+        $table->timestamp('deleted_at')->nullable();
+    });
+    $schema->create('service_rates', function ($table) {
+        $table->increments('id');
+        $table->string('uuid')->nullable();
+        $table->string('public_id')->nullable();
+        $table->string('company_uuid')->nullable();
+        $table->string('currency')->nullable();
+        $table->string('service_type')->nullable();
+        $table->timestamp('deleted_at')->nullable();
+    });
+    $schema->create('places', function ($table) {
+        $table->increments('id');
+        $table->string('uuid')->nullable();
+        $table->string('public_id')->nullable();
+        $table->string('company_uuid')->nullable();
+        $table->string('name')->nullable();
+        $table->timestamp('deleted_at')->nullable();
+    });
+    $schema->create('integrated_vendors', function ($table) {
+        $table->increments('id');
+        $table->string('uuid')->nullable();
+        $table->string('public_id')->nullable();
+        $table->string('company_uuid')->nullable();
+        $table->string('provider')->nullable();
+        $table->timestamp('deleted_at')->nullable();
+    });
+
+    return $connection;
+}
+
+function fleetopsApiServiceQuoteQueryRequest(array $input): QueryServiceQuotesRequest
+{
+    $request = new QueryServiceQuotesRequest($input);
+    $request->setLaravelSession(app('session.store'));
+
+    return $request;
+}
+
+/*
+|--------------------------------------------------------------------------
+| query() endpoint branches
+|--------------------------------------------------------------------------
+*/
+
+test('query falls back to preliminary quoting when no payload resolves', function () {
+    fleetopsApiServiceQuoteQueryBoot();
+    $probe = new FleetOpsApiServiceQuoteQueryProbe();
+
+    $result = $probe->query(fleetopsApiServiceQuoteQueryRequest(['payload' => ['pickup' => '1 Main St']]));
+
+    expect($result)->toBe('preliminary-fallback')
+        ->and($probe->preliminaryCalls)->toHaveCount(1);
+});
+
+test('query returns an empty collection when the integrated vendor is missing', function () {
+    fleetopsApiServiceQuoteQueryBoot();
+    $probe   = new FleetOpsApiServiceQuoteQueryProbe();
+    $payload = new FleetOpsApiServiceQuoteQueryPayloadFake();
+
+    $result = $probe->query(fleetopsApiServiceQuoteQueryRequest([
+        'payload'     => $payload,
+        'facilitator' => 'integrated_vendor_missing',
+    ]));
+
+    expect($result)->toBeInstanceOf(Illuminate\Http\Resources\Json\ResourceCollection::class)
+        ->and($result->count())->toBe(0);
+});
+
+test('query builds a single-service quote with items from the matched rate', function () {
+    fleetopsApiServiceQuoteQueryBoot();
+    $probe              = new FleetOpsApiServiceQuoteQueryProbe();
+    $rate               = new FleetOpsApiServiceQuoteQueryRateFake();
+    $rate->setRawAttributes(['uuid' => 'rate-1', 'company_uuid' => 'company-1', 'currency' => 'USD'], true);
+    $probe->serviceRate = $rate;
+
+    $single = $probe->query(fleetopsApiServiceQuoteQueryRequest([
+        'payload' => new FleetOpsApiServiceQuoteQueryPayloadFake(),
+        'service' => 'rate-1',
+        'single'  => '1',
+    ]));
+
+    expect($single)->toBeInstanceOf(ServiceQuoteResource::class)
+        ->and($probe->createdQuotes[0]['amount'])->toBe(4900)
+        ->and($probe->createdQuotes[0]['service_rate_uuid'])->toBe('rate-1')
+        ->and($probe->createdItems[0]['code'])->toBe('BASE');
+
+    $collection = $probe->query(fleetopsApiServiceQuoteQueryRequest([
+        'payload' => new FleetOpsApiServiceQuoteQueryPayloadFake(),
+        'service' => 'rate-1',
+    ]));
+
+    expect($collection)->toBeInstanceOf(Illuminate\Http\Resources\Json\ResourceCollection::class)
+        ->and($collection->count())->toBe(1);
+});
+
+test('query quotes all servicable rates and picks the best for single requests', function () {
+    fleetopsApiServiceQuoteQueryBoot();
+    $probe = new FleetOpsApiServiceQuoteQueryProbe();
+    $rate  = new FleetOpsApiServiceQuoteQueryRateFake();
+    $rate->setRawAttributes(['uuid' => 'rate-2', 'company_uuid' => 'company-1', 'currency' => 'USD'], true);
+    $probe->servicableRates = [$rate];
+    session(['company' => 'company-1']);
+
+    $collection = $probe->query(fleetopsApiServiceQuoteQueryRequest([
+        'payload' => new FleetOpsApiServiceQuoteQueryPayloadFake(),
+    ]));
+
+    expect($collection)->toBeInstanceOf(Illuminate\Http\Resources\Json\ResourceCollection::class)
+        ->and($collection->count())->toBe(1)
+        ->and($probe->createdItems[0]['details'])->toBe('Base fee');
+
+    $best = $probe->query(fleetopsApiServiceQuoteQueryRequest([
+        'payload' => new FleetOpsApiServiceQuoteQueryPayloadFake(),
+        'single'  => '1',
+    ]));
+
+    expect($best)->toBeInstanceOf(ServiceQuoteResource::class);
+});
+
+/*
+|--------------------------------------------------------------------------
+| Real protected helper bodies
+|--------------------------------------------------------------------------
+*/
+
+test('service quote helpers execute their real implementations', function () {
+    $connection = fleetopsApiServiceQuoteQueryBoot();
+    $controller = new class extends ServiceQuoteController {
+        public function callProtected(string $method, array $arguments = []): mixed
+        {
+            $reflection = new ReflectionMethod(ServiceQuoteController::class, $method);
+            $reflection->setAccessible(true);
+
+            return $reflection->invoke($this, ...$arguments);
+        }
+    };
+
+    // generateServiceQuoteRequestId
+    $requestId = $controller->callProtected('generateServiceQuoteRequestId');
+    expect($requestId)->toStartWith('request_');
+
+    // createPlaceFromMixed returns existing instances untouched
+    $place = new Place();
+    $place->setRawAttributes(['uuid' => 'place-1'], true);
+    expect($controller->callProtected('createPlaceFromMixed', [$place]))->toBe($place);
+
+    // findPlaceByPublicId queries the database
+    $connection->table('places')->insert(['uuid' => 'place-2', 'public_id' => 'place_test', 'company_uuid' => 'company-1']);
+    $found = $controller->callProtected('findPlaceByPublicId', ['place_test']);
+    expect($found)->toBeInstanceOf(Place::class)
+        ->and($found->uuid)->toBe('place-2');
+
+    // distanceMatrix uses the calculate provider
+    config()->set('fleetops.distance_matrix.provider', 'calculate');
+    $origin = new Place();
+    $origin->setRawAttributes(['uuid' => 'o1', 'location' => new Point(1.0, 2.0)], true);
+    $destination = new Place();
+    $destination->setRawAttributes(['uuid' => 'd1', 'location' => new Point(1.5, 2.5)], true);
+    $matrix = $controller->callProtected('distanceMatrix', [[$origin], [$destination]]);
+    expect($matrix->distance)->toBeGreaterThan(0)
+        ->and($matrix->time)->toBeGreaterThan(0);
+
+    // findServiceRateForQuote matches by uuid/public id and currency
+    $connection->table('service_rates')->insert(['uuid' => 'rate-uuid', 'public_id' => 'service_rate_x', 'currency' => 'USD', 'company_uuid' => 'company-1']);
+    $rate = $controller->callProtected('findServiceRateForQuote', ['rate-uuid', 'usd']);
+    expect($rate)->toBeInstanceOf(ServiceRate::class)
+        ->and($rate->uuid)->toBe('rate-uuid');
+
+    // findServiceRateByUuid
+    $byUuid = $controller->callProtected('findServiceRateByUuid', ['rate-uuid']);
+    expect($byUuid)->toBeInstanceOf(ServiceRate::class);
+
+    // getServicableServiceRates delegates to the model with the scoping callback
+    $rates = $controller->callProtected('getServicableServiceRates', [[], 'delivery', 'USD', function ($query) {
+        $query->where('company_uuid', 'company-1');
+    }]);
+    expect(is_iterable($rates))->toBeTrue();
+
+    // createServiceQuote and createServiceQuoteItem persist records
+    $quote = $controller->callProtected('createServiceQuote', [[
+        'request_id'        => $requestId,
+        'company_uuid'      => 'company-1',
+        'service_rate_uuid' => 'rate-uuid',
+        'amount'            => 100,
+        'currency'          => 'USD',
+    ]]);
+    expect($quote)->toBeInstanceOf(ServiceQuote::class)
+        ->and($connection->table('service_quotes')->count())->toBe(1);
+
+    $item = $controller->callProtected('createServiceQuoteItem', [[
+        'service_quote_uuid' => $quote->uuid,
+        'amount'             => 100,
+        'currency'           => 'USD',
+        'details'            => 'Base',
+        'code'               => 'BASE',
+    ]]);
+    expect($item)->toBeInstanceOf(ServiceQuoteItem::class)
+        ->and($connection->table('service_quote_items')->count())->toBe(1);
+
+    // resource wrappers
+    expect($controller->callProtected('serviceQuoteResource', [$quote]))->toBeInstanceOf(ServiceQuoteResource::class)
+        ->and($controller->callProtected('serviceQuoteResourceCollection', [[$quote]]))
+        ->toBeInstanceOf(Illuminate\Http\Resources\Json\ResourceCollection::class);
+
+    // jsonResponse
+    $response = $controller->callProtected('jsonResponse', [['ok' => true], 201]);
+    expect($response)->toBeInstanceOf(JsonResponse::class)
+        ->and($response->getStatusCode())->toBe(201);
+});
+
+test('find service quote helper loads records and reports missing ones', function () {
+    $connection = fleetopsApiServiceQuoteQueryBoot();
+    $controller = new class extends ServiceQuoteController {
+        public function callProtected(string $method, array $arguments = []): mixed
+        {
+            $reflection = new ReflectionMethod(ServiceQuoteController::class, $method);
+            $reflection->setAccessible(true);
+
+            return $reflection->invoke($this, ...$arguments);
+        }
+    };
+
+    $connection->table('service_quotes')->insert(['uuid' => 'sq-1', 'public_id' => 'service_quote_x', 'company_uuid' => 'company-1']);
+
+    $found = $controller->callProtected('findServiceQuote', ['service_quote_x']);
+    expect($found)->toBeInstanceOf(ServiceQuote::class)
+        ->and($found->uuid)->toBe('sq-1');
+
+    expect(fn () => $controller->callProtected('findServiceQuote', ['missing']))
+        ->toThrow(Illuminate\Database\Eloquent\ModelNotFoundException::class);
+});

package/server/tests/Feature/Http/Api/ServiceQuoteControllerVendorBridgeTest.php

@@ -0,0 +1,212 @@
+<?php
+
+use Fleetbase\FleetOps\Http\Controllers\Api\v1\ServiceQuoteController;
+use Fleetbase\FleetOps\Http\Requests\QueryServiceQuotesRequest;
+use Fleetbase\FleetOps\Http\Resources\v1\ServiceQuote as ServiceQuoteResource;
+use Fleetbase\FleetOps\Models\ServiceQuote;
+use Illuminate\Database\ConnectionResolver;
+use Illuminate\Database\Eloquent\Model as EloquentModel;
+use Illuminate\Database\SQLiteConnection;
+use Illuminate\Http\JsonResponse;
+
+/**
+ * Covers the API ServiceQuoteController integrated-vendor quoting branches
+ * through the container-injectable vendor bridge: payload-backed vendor
+ * quotes (single and collection), preliminary vendor quotes resolved by
+ * provider name, and bridge failures surfacing as 400 error responses.
+ */
+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); }');
+}
+
+class FleetOpsQuoteBridgeQuoteFake extends ServiceQuote
+{
+    protected $guarded = [];
+    public $exists     = true;
+}
+
+function fleetopsQuoteVendorBridgeBoot(): SQLiteConnection
+{
+    $connection = new SQLiteConnection(new PDO('sqlite::memory:'));
+    $resolver   = new ConnectionResolver(['default' => $connection, 'mysql' => $connection]);
+    $resolver->setDefaultConnection('mysql');
+    EloquentModel::setConnectionResolver($resolver);
+    if (!EloquentModel::getEventDispatcher()) {
+        EloquentModel::setEventDispatcher(new Illuminate\Events\Dispatcher());
+    }
+    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();
+    app()->instance('db.schema', $schema);
+    $tables = [
+        'service_quotes'     => ['uuid', 'public_id', 'request_id', 'company_uuid', 'service_rate_uuid', 'payload_uuid', 'integrated_vendor_uuid', 'amount', 'currency', 'meta', 'expired_at', '_key'],
+        'integrated_vendors' => ['uuid', 'public_id', 'company_uuid', 'provider', 'webhook_url', 'host', 'namespace', 'credentials', 'options', 'sandbox', 'status', '_key'],
+        'payloads'           => ['uuid', 'public_id', 'company_uuid', 'pickup_uuid', 'dropoff_uuid', 'return_uuid', 'current_waypoint_uuid', 'type', 'meta', '_key'],
+        'places'             => ['uuid', 'public_id', 'company_uuid', 'name', 'location', '_key'],
+        'waypoints'          => ['uuid', 'public_id', 'company_uuid', 'payload_uuid', 'place_uuid', 'order', 'type', 'status', '_key'],
+        'entities'           => ['uuid', 'public_id', 'company_uuid', 'payload_uuid', 'name', 'type', 'status', 'meta', '_key'],
+    ];
+    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();
+        });
+    }
+
+    session(['company' => 'company-1']);
+    $connection->table('integrated_vendors')->insert(['uuid' => 'iv-quote-1', 'public_id' => 'integrated_vendor_quotelala1', 'company_uuid' => 'company-1', 'provider' => 'lalamove', 'credentials' => json_encode([]), 'options' => json_encode([]), 'sandbox' => '1']);
+    $connection->table('payloads')->insert(['uuid' => 'payload-quote-1', 'public_id' => 'payload_vendorquote1', 'company_uuid' => 'company-1']);
+    $connection->table('places')->insert([
+        ['uuid' => 'place-quote-pickup', 'public_id' => 'place_quotepickup1', 'company_uuid' => 'company-1', 'name' => 'Pickup'],
+        ['uuid' => 'place-quote-dropoff', 'public_id' => 'place_quotedropoff1', 'company_uuid' => 'company-1', 'name' => 'Dropoff'],
+    ]);
+    $connection->table('service_quotes')->insert(['uuid' => 'quote-bridge-1', 'public_id' => 'quote_bridgeone1', 'company_uuid' => 'company-1', 'amount' => '3500', 'currency' => 'SGD', 'meta' => json_encode([])]);
+
+    $GLOBALS['fleetopsQuoteBridgeMode'] = 'ok';
+    app()->bind(Fleetbase\FleetOps\Integrations\Lalamove\Lalamove::class, function () {
+        return new class {
+            public function setIntegratedVendor($vendor)
+            {
+                return $this;
+            }
+
+            public function setRequestId($id)
+            {
+                return $this;
+            }
+
+            protected function makeQuote(): ServiceQuote
+            {
+                $quote = new FleetOpsQuoteBridgeQuoteFake();
+                $quote->setRawAttributes(['uuid' => 'quote-bridge-1', 'public_id' => 'quote_bridgeone1', 'company_uuid' => 'company-1', 'amount' => '3500', 'currency' => 'SGD', 'meta' => json_encode([])], true);
+
+                return $quote;
+            }
+
+            public function getQuoteFromPayload($payload, $serviceType = null, $scheduledAt = null, $isRouteOptimized = true)
+            {
+                if ($GLOBALS['fleetopsQuoteBridgeMode'] === 'fail') {
+                    throw new Exception('vendor quote unavailable');
+                }
+
+                return $this->makeQuote();
+            }
+
+            public function getQuoteFromPreliminaryPayload($waypoints, $entities, $serviceType = null, $scheduledAt = null, $isRouteOptimized = true)
+            {
+                if ($GLOBALS['fleetopsQuoteBridgeMode'] === 'fail') {
+                    throw new Exception('vendor preliminary quote unavailable');
+                }
+
+                return $this->makeQuote();
+            }
+
+            public function __call($method, $arguments)
+            {
+                return $this;
+            }
+        };
+    });
+
+    return $connection;
+}
+
+function fleetopsQuoteVendorBridgeRequest(array $input): QueryServiceQuotesRequest
+{
+    $request = new QueryServiceQuotesRequest($input);
+    $request->setLaravelSession(app('session.store'));
+
+    return $request;
+}
+
+test('payload backed vendor quotes return single and collection responses', function () {
+    fleetopsQuoteVendorBridgeBoot();
+    $controller = new ServiceQuoteController();
+
+    $single = $controller->query(fleetopsQuoteVendorBridgeRequest([
+        'payload'     => 'payload_vendorquote1',
+        'facilitator' => 'integrated_vendor_quotelala1',
+        'single'      => '1',
+    ]));
+    expect($single)->toBeInstanceOf(ServiceQuoteResource::class);
+
+    $collection = $controller->query(fleetopsQuoteVendorBridgeRequest([
+        'payload'     => 'payload_vendorquote1',
+        'facilitator' => 'integrated_vendor_quotelala1',
+    ]));
+    expect($collection)->toBeInstanceOf(Illuminate\Http\Resources\Json\ResourceCollection::class);
+});
+
+test('payload vendor bridge failures surface as 400 error responses', function () {
+    fleetopsQuoteVendorBridgeBoot();
+    $GLOBALS['fleetopsQuoteBridgeMode'] = 'fail';
+
+    $response = (new ServiceQuoteController())->query(fleetopsQuoteVendorBridgeRequest([
+        'payload'     => 'payload_vendorquote1',
+        'facilitator' => 'integrated_vendor_quotelala1',
+    ]));
+    $GLOBALS['fleetopsQuoteBridgeMode'] = 'ok';
+
+    expect($response)->toBeInstanceOf(JsonResponse::class)
+        ->and($response->getStatusCode())->toBe(400)
+        ->and(json_encode($response->getData(true)))->toContain('vendor quote unavailable');
+});
+
+test('preliminary vendor quotes resolve by provider name through the bridge', function () {
+    $connection = fleetopsQuoteVendorBridgeBoot();
+    $controller = new ServiceQuoteController();
+
+    // Model pickups exercise the non-scalar place resolution branch, and the
+    // public-id facilitator hits the fast integrated-vendor id check
+    $pickupPlace = Fleetbase\FleetOps\Models\Place::where('uuid', 'place-quote-pickup')->first();
+    $single      = $controller->queryFromPreliminary(fleetopsQuoteVendorBridgeRequest([
+        'pickup'      => $pickupPlace,
+        'dropoff'     => 'place_quotedropoff1',
+        'facilitator' => 'integrated_vendor_quotelala1',
+        'single'      => '1',
+    ]));
+    expect($single)->toBeInstanceOf(ServiceQuoteResource::class)
+        ->and((string) $connection->table('service_quotes')->where('uuid', 'quote-bridge-1')->value('meta'))->toContain('preliminary_data');
+
+    $collection = $controller->queryFromPreliminary(fleetopsQuoteVendorBridgeRequest([
+        'pickup'      => 'place_quotepickup1',
+        'dropoff'     => 'place_quotedropoff1',
+        'facilitator' => 'lalamove',
+    ]));
+    expect($collection)->toBeInstanceOf(Illuminate\Http\Resources\Json\ResourceCollection::class);
+});
+
+test('preliminary vendor bridge failures surface as 400 error responses', function () {
+    fleetopsQuoteVendorBridgeBoot();
+    $GLOBALS['fleetopsQuoteBridgeMode'] = 'fail';
+
+    $response = (new ServiceQuoteController())->queryFromPreliminary(fleetopsQuoteVendorBridgeRequest([
+        'pickup'      => 'place_quotepickup1',
+        'dropoff'     => 'place_quotedropoff1',
+        'facilitator' => 'lalamove',
+    ]));
+    $GLOBALS['fleetopsQuoteBridgeMode'] = 'ok';
+
+    expect($response)->toBeInstanceOf(JsonResponse::class)
+        ->and($response->getStatusCode())->toBe(400)
+        ->and(json_encode($response->getData(true)))->toContain('vendor preliminary quote unavailable');
+});