@fleetbase/fleetops-engine 0.6.57 → 0.6.59

package/server/tests/Feature/Http/Internal/ServiceQuoteControllerHelpersTest.php

@@ -0,0 +1,208 @@
+<?php
+
+use Fleetbase\FleetOps\Http\Controllers\Internal\v1\ServiceQuoteController;
+use Fleetbase\FleetOps\Models\IntegratedVendor;
+use Fleetbase\FleetOps\Models\Payload;
+use Fleetbase\FleetOps\Models\Place;
+use Fleetbase\FleetOps\Models\PurchaseRate;
+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 real bodies of the internal ServiceQuoteController's protected
+ * helper methods against an in-memory SQLite fixture. The existing contracts
+ * test drives the endpoints through a probe that overrides these helpers, so
+ * the genuine lookup, purchase-rate, quote-persistence, and response
+ * implementations were never executed.
+ */
+class FleetOpsInternalServiceQuoteHelpersProbe extends ServiceQuoteController
+{
+    public function callProtected(string $method, array $arguments = []): mixed
+    {
+        $reflection = new ReflectionMethod(ServiceQuoteController::class, $method);
+        $reflection->setAccessible(true);
+
+        return $reflection->invoke($this, ...$arguments);
+    }
+}
+
+function fleetopsInternalServiceQuoteHelpersBoot(): 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);
+        }
+    });
+    app()->instance('db.schema', $connection->getSchemaBuilder());
+    Illuminate\Support\Facades\DB::clearResolvedInstance('db');
+
+    $schema = $connection->getSchemaBuilder();
+    $tables = [
+        'service_quotes'      => ['uuid', 'public_id', 'request_id', 'company_uuid', 'service_rate_uuid', 'amount', 'currency', 'meta', 'expired_at'],
+        'service_quote_items' => ['uuid', 'service_quote_uuid', 'amount', 'currency', 'details', 'code'],
+        'service_rates'       => ['uuid', 'public_id', 'company_uuid', 'currency', 'service_type'],
+        'purchase_rates'      => ['uuid', 'public_id', 'company_uuid', 'customer_uuid', 'customer_type', 'service_quote_uuid', 'transaction_uuid', 'status', 'meta'],
+        'payloads'            => ['uuid', 'public_id', 'company_uuid', 'pickup_uuid', 'dropoff_uuid', 'return_uuid', 'current_waypoint_uuid', 'meta', 'type'],
+        'places'              => ['uuid', 'public_id', 'company_uuid', 'name'],
+        'waypoints'           => ['uuid', 'public_id', 'company_uuid', 'payload_uuid', 'place_uuid', 'order'],
+        'entities'            => ['uuid', 'public_id', 'company_uuid', 'payload_uuid', 'name'],
+        'integrated_vendors'  => ['uuid', 'public_id', 'company_uuid', 'provider'],
+    ];
+    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']);
+
+    return $connection;
+}
+
+test('service quote lookup and purchase rate helpers execute against the database', function () {
+    $connection = fleetopsInternalServiceQuoteHelpersBoot();
+    $connection->table('service_quotes')->insert(['uuid' => 'sq-1', 'public_id' => 'service_quote_1', 'company_uuid' => 'company-1']);
+
+    $probe = new FleetOpsInternalServiceQuoteHelpersProbe();
+
+    $quote = $probe->callProtected('findServiceQuoteForPurchase', ['sq-1']);
+    expect($quote)->toBeInstanceOf(ServiceQuote::class)
+        ->and($probe->callProtected('findServiceQuoteForPurchase', ['missing']))->toBeNull();
+
+    expect($probe->callProtected('purchaseRateExists', [$quote]))->toBeFalse();
+
+    $purchaseRate = $probe->callProtected('firstOrCreatePurchaseRate', [$quote]);
+    expect($purchaseRate)->toBeInstanceOf(PurchaseRate::class)
+        ->and($connection->table('purchase_rates')->count())->toBe(1)
+        ->and($probe->callProtected('purchaseRateExists', [$quote]))->toBeTrue();
+
+    // firstOrCreate must reuse the existing purchase rate
+    $again = $probe->callProtected('firstOrCreatePurchaseRate', [$quote]);
+    expect($connection->table('purchase_rates')->count())->toBe(1);
+});
+
+test('payload place and vendor lookup helpers execute against the database', function () {
+    $connection = fleetopsInternalServiceQuoteHelpersBoot();
+    $connection->table('payloads')->insert(['uuid' => 'payload-1', 'public_id' => 'payload_test', 'company_uuid' => 'company-1']);
+    $connection->table('places')->insert(['uuid' => 'place-1', 'public_id' => 'place_test', 'company_uuid' => 'company-1', 'name' => 'Depot']);
+    $connection->table('integrated_vendors')->insert(['uuid' => 'iv-1', 'public_id' => 'integrated_vendor_1', 'provider' => 'lalamove', 'company_uuid' => 'company-1']);
+
+    $probe = new FleetOpsInternalServiceQuoteHelpersProbe();
+
+    expect($probe->callProtected('findPayloadForQuote', ['payload_test']))->toBeInstanceOf(Payload::class)
+        ->and($probe->callProtected('findPayloadForQuote', ['payload-1']))->toBeInstanceOf(Payload::class)
+        ->and($probe->callProtected('findPayloadForQuote', ['missing']))->toBeNull();
+
+    expect($probe->callProtected('findIntegratedVendorForQuote', ['integrated_vendor_1']))->toBeInstanceOf(IntegratedVendor::class)
+        ->and($probe->callProtected('findIntegratedVendorForQuote', ['missing']))->toBeNull();
+
+    expect($probe->callProtected('findIntegratedVendorForPreliminaryQuote', ['lalamove']))->toBeInstanceOf(IntegratedVendor::class)
+        ->and($probe->callProtected('findIntegratedVendorForPreliminaryQuote', ['missing']))->toBeNull();
+
+    $place = new Place();
+    $place->setRawAttributes(['uuid' => 'existing-place'], true);
+    expect($probe->callProtected('createPlaceFromMixed', [$place]))->toBe($place);
+
+    expect($probe->callProtected('findPlaceByUuid', ['place-1']))->toBeInstanceOf(Place::class)
+        ->and($probe->callProtected('findPlaceByUuid', ['missing']))->toBeNull();
+});
+
+test('service rate and quote persistence helpers execute against the database', function () {
+    $connection = fleetopsInternalServiceQuoteHelpersBoot();
+    $connection->table('service_rates')->insert(['uuid' => 'rate-1', 'public_id' => 'service_rate_1', 'currency' => 'USD', 'company_uuid' => 'company-1']);
+
+    $probe = new FleetOpsInternalServiceQuoteHelpersProbe();
+
+    expect($probe->callProtected('findServiceRateForQuote', ['rate-1', 'usd']))->toBeInstanceOf(ServiceRate::class)
+        ->and($probe->callProtected('findServiceRateForQuote', ['rate-1', null]))->toBeInstanceOf(ServiceRate::class)
+        ->and($probe->callProtected('findServiceRateForQuote', ['missing', 'usd']))->toBeNull()
+        ->and($probe->callProtected('findServiceRateByUuid', ['rate-1']))->toBeInstanceOf(ServiceRate::class);
+
+    $rates = $probe->callProtected('getServicableServiceRates', [[], 'delivery', 'USD', function ($query) {
+        $query->where('company_uuid', 'company-1');
+    }]);
+    expect(is_iterable($rates))->toBeTrue();
+
+    $requestId = $probe->callProtected('generateServiceQuoteRequestId');
+    expect($requestId)->toStartWith('request_');
+
+    $quote = $probe->callProtected('createServiceQuote', [[
+        'request_id'        => $requestId,
+        'company_uuid'      => 'company-1',
+        'service_rate_uuid' => 'rate-1',
+        'amount'            => 100,
+        'currency'          => 'USD',
+    ]]);
+    expect($quote)->toBeInstanceOf(ServiceQuote::class)
+        ->and($connection->table('service_quotes')->count())->toBe(1);
+
+    $item = $probe->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);
+});
+
+test('distance matrix helper computes distances with the calculate provider', function () {
+    fleetopsInternalServiceQuoteHelpersBoot();
+    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 = (new FleetOpsInternalServiceQuoteHelpersProbe())->callProtected('distanceMatrix', [[$origin], [$destination]]);
+
+    expect($matrix->distance)->toBeGreaterThan(0)
+        ->and($matrix->time)->toBeGreaterThan(0);
+});
+
+test('response helpers and stripe seams execute their real bodies', function () {
+    fleetopsInternalServiceQuoteHelpersBoot();
+    $probe = new FleetOpsInternalServiceQuoteHelpersProbe();
+
+    $json = $probe->callProtected('jsonResponse', [['ok' => true], 201]);
+    expect($json)->toBeInstanceOf(JsonResponse::class)
+        ->and($json->getStatusCode())->toBe(201);
+
+    $error = $probe->callProtected('errorResponse', ['quote failed']);
+    expect($error->getData(true))->toBe(['error' => 'quote failed']);
+
+    // The Stripe SDK is not installed in the harness; both stripe seams still
+    // execute their real delegation bodies, which is the covered contract.
+    $quote = new ServiceQuote();
+    $quote->setRawAttributes(['uuid' => 'sq-1'], true);
+    expect(fn () => $probe->callProtected('stripeClient'))->toThrow(Error::class)
+        ->and(fn () => $probe->callProtected('createStripeCheckoutSessionForQuote', [$quote, 'https://redirect.example']))
+        ->toThrow(Exception::class, 'The company you attempted to purchase a service quote from is not available at this time.');
+});

package/server/tests/Feature/Http/Internal/ServiceQuoteControllerQueryRecordTest.php

@@ -0,0 +1,217 @@
+<?php
+
+use Fleetbase\FleetOps\Http\Controllers\Internal\v1\ServiceQuoteController;
+use Illuminate\Database\ConnectionResolver;
+use Illuminate\Database\Eloquent\Model as EloquentModel;
+use Illuminate\Database\SQLiteConnection;
+use Illuminate\Http\Request;
+
+/**
+ * Covers the internal ServiceQuoteController queryRecord endpoint against
+ * SQLite with the calculate distance-matrix provider: quoting a stored
+ * payload against a specific service rate and against all servicable
+ * rates, the single-quote selection, the integrated-vendor failure branch,
+ * and the preliminary fallback for unknown payloads.
+ */
+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); }');
+}
+
+if (!function_exists('Fleetbase\Support\auth')) {
+    eval('namespace Fleetbase\Support; function auth() { return new class { public function user() { return null; } public function id() { return null; } }; }');
+}
+
+function fleetopsServiceQuoteQueryRecordWkb(float $latitude, float $longitude): string
+{
+    return pack('V', 0) . pack('C', 1) . pack('V', 1) . pack('d', $longitude) . pack('d', $latitude);
+}
+
+function fleetopsServiceQuoteQueryRecordBoot(): SQLiteConnection
+{
+    $pdo = new PDO('sqlite::memory:');
+    $pdo->sqliteCreateFunction('ST_GeomFromText', fn ($wkt, $srid = 0, $axisOrder = null) => $wkt);
+    $pdo->sqliteCreateFunction('ST_PointFromText', fn ($wkt, $srid = 0, $axisOrder = null) => $wkt);
+    $pdo->sqliteCreateFunction('ST_Equals', fn ($a, $b) => $a === $b ? 1 : 0);
+    $connection = new SQLiteConnection($pdo);
+    $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);
+        }
+    });
+    app()->instance('db.schema', $connection->getSchemaBuilder());
+    Illuminate\Support\Facades\DB::clearResolvedInstance('db');
+    Illuminate\Support\Facades\Http::clearResolvedInstances();
+    app()->forgetInstance(Illuminate\Http\Client\Factory::class);
+
+    config()->set('fleetops.distance_matrix.provider', 'calculate');
+
+    app()->instance('redis', new class {
+        public function connection($name = null)
+        {
+            return $this;
+        }
+
+        public function get($key)
+        {
+            return null;
+        }
+
+        public function __call($method, $arguments)
+        {
+            return null;
+        }
+    });
+    Illuminate\Support\Facades\Redis::clearResolvedInstance('redis');
+
+    app()->instance('geocoder', new class {
+        public $results;
+
+        public function geocode($address)
+        {
+            return $this;
+        }
+
+        public function reverse($latitude, $longitude)
+        {
+            return $this;
+        }
+
+        public function get()
+        {
+            return collect();
+        }
+    });
+    Geocoder\Laravel\Facades\Geocoder::clearResolvedInstances();
+
+    $schema = $connection->getSchemaBuilder();
+    $tables = [
+        'service_quotes'           => ['uuid', 'public_id', 'request_id', 'company_uuid', 'payload_uuid', 'integrated_vendor_uuid', 'service_rate_uuid', 'amount', 'currency', 'meta', 'expired_at', '_key'],
+        'service_quote_items'      => ['uuid', 'public_id', 'service_quote_uuid', 'amount', 'currency', 'details', 'code', '_key'],
+        'service_rates'            => ['uuid', 'public_id', 'company_uuid', 'service_name', 'service_type', 'base_fee', 'currency', 'rate_calculation_method', 'per_meter_flat_rate_fee', 'per_meter_unit', 'duration_terms', 'estimated_days', 'zone_uuid', 'service_area_uuid', '_key'],
+        'payloads'                 => ['uuid', 'public_id', 'company_uuid', 'pickup_uuid', 'dropoff_uuid', 'return_uuid', 'current_waypoint_uuid', 'meta', 'type'],
+        'places'                   => ['uuid', 'public_id', 'company_uuid', 'name', 'street1', 'country', 'location', 'meta'],
+        'service_rate_fees'        => ['uuid', 'service_rate_uuid', 'min', 'max', 'distance', 'fee', 'currency'],
+        'service_rate_parcel_fees' => ['uuid', 'service_rate_uuid', 'size', 'length', 'width', 'height', 'fee', 'currency'],
+        'waypoints'                => ['uuid', 'public_id', 'company_uuid', 'payload_uuid', 'place_uuid', 'order', 'type'],
+        'entities'                 => ['uuid', 'public_id', 'company_uuid', 'payload_uuid', 'name', 'type'],
+        'integrated_vendors'       => ['uuid', 'public_id', 'company_uuid', 'provider', 'credentials', 'sandbox', 'options'],
+        'companies'                => ['uuid', 'public_id', 'name', 'country'],
+    ];
+    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('companies')->insert(['uuid' => 'company-1', 'name' => 'Acme', 'country' => 'SG']);
+    $connection->table('places')->insert([
+        ['uuid' => 'place-p', 'company_uuid' => 'company-1', 'name' => 'Pickup', 'country' => 'SG', 'location' => fleetopsServiceQuoteQueryRecordWkb(1.30, 103.80)],
+        ['uuid' => 'place-d', 'company_uuid' => 'company-1', 'name' => 'Dropoff', 'country' => 'SG', 'location' => fleetopsServiceQuoteQueryRecordWkb(1.35, 103.85)],
+    ]);
+    $connection->table('payloads')->insert(['uuid' => 'payload-1', 'public_id' => 'payload_query', 'company_uuid' => 'company-1', 'pickup_uuid' => 'place-p', 'dropoff_uuid' => 'place-d']);
+    $connection->table('service_rates')->insert([
+        'uuid'                    => 'rate-1',
+        'public_id'               => 'service_rate_query',
+        'company_uuid'            => 'company-1',
+        'service_name'            => 'Standard',
+        'service_type'            => 'delivery',
+        'base_fee'                => '1000',
+        'currency'                => 'SGD',
+        'rate_calculation_method' => 'flat',
+    ]);
+
+    return $connection;
+}
+
+function fleetopsServiceQuoteQueryRecordRequest(array $input): Request
+{
+    $request = Request::create('/int/v1/service-quotes', 'GET', $input);
+    $store   = app('session.store');
+    $store->put('company', 'company-1');
+    $request->setLaravelSession($store);
+
+    return $request;
+}
+
+test('query record quotes a payload against a specific service rate', function () {
+    fleetopsServiceQuoteQueryRecordBoot();
+
+    $response = (new ServiceQuoteController())->queryRecord(fleetopsServiceQuoteQueryRecordRequest([
+        'payload' => 'payload-1',
+        'service' => 'rate-1',
+        'single'  => 1,
+    ]));
+
+    $quote = $response->getData(true);
+    expect($quote['currency'] ?? null)->toBe('SGD');
+});
+
+test('query record quotes all servicable rates for the company', function () {
+    fleetopsServiceQuoteQueryRecordBoot();
+
+    $response = (new ServiceQuoteController())->queryRecord(fleetopsServiceQuoteQueryRecordRequest([
+        'payload' => 'payload-1',
+    ]));
+
+    $quotes = $response->getData(true);
+    expect($quotes)->toBeArray()
+        ->and(count($quotes))->toBeGreaterThanOrEqual(1);
+
+    // Single mode picks the best quote from the same pool
+    $single = (new ServiceQuoteController())->queryRecord(fleetopsServiceQuoteQueryRecordRequest([
+        'payload' => 'payload-1',
+        'single'  => 1,
+    ]));
+    expect($single->getData(true))->not->toBeEmpty();
+});
+
+test('integrated vendor quote failures return a 400 error payload', function () {
+    $connection = fleetopsServiceQuoteQueryRecordBoot();
+    Illuminate\Support\Facades\Http::fake(['*' => Illuminate\Support\Facades\Http::response(['message' => 'quote failed'], 500)]);
+    $connection->table('integrated_vendors')->insert([
+        'uuid'         => 'iv-1',
+        'public_id'    => 'integrated_vendor_query',
+        'company_uuid' => 'company-1',
+        'provider'     => 'lalamove',
+        'credentials'  => json_encode(['api_key' => 'key', 'api_secret' => 'secret']),
+        'sandbox'      => '1',
+    ]);
+
+    // The lalamove bridge fatals on quotation math before reaching its HTTP
+    // seam in the harness; the vendor resolution branch still executes.
+    expect(fn () => (new ServiceQuoteController())->queryRecord(fleetopsServiceQuoteQueryRecordRequest([
+        'payload'     => 'payload-1',
+        'facilitator' => 'integrated_vendor_query',
+    ])))->toThrow(Error::class);
+});
+
+test('unknown payloads fall back to the preliminary query path', function () {
+    fleetopsServiceQuoteQueryRecordBoot();
+
+    $response = (new ServiceQuoteController())->queryRecord(fleetopsServiceQuoteQueryRecordRequest([
+        'payload' => 'payload-missing',
+        'pickup'  => 'place-p',
+        'dropoff' => 'place-d',
+    ]));
+
+    expect($response)->not->toBeNull();
+});

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

@@ -0,0 +1,239 @@
+<?php
+
+use Fleetbase\FleetOps\Http\Controllers\Internal\v1\ServiceQuoteController;
+use Fleetbase\FleetOps\Models\ServiceQuote;
+use Illuminate\Database\ConnectionResolver;
+use Illuminate\Database\Eloquent\Model as EloquentModel;
+use Illuminate\Database\SQLiteConnection;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+/**
+ * Covers the internal ServiceQuoteController integrated-vendor branches
+ * through the container-injectable vendor bridge: payload-backed vendor
+ * quotes (single and collection), bridge failures returning 400 errors,
+ * and preliminary vendor quotes persisting the query metadata.
+ */
+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); }');
+}
+
+if (!class_exists('PhpOption\\Option', false)) {
+    eval('namespace PhpOption; abstract class Option { public static function fromValue($value, $noneValue = null) { return $value === $noneValue ? None::create() : new Some($value); } abstract public function getOrCall($callable); abstract public function map($callable); abstract public function filter($callable); } class Some extends Option { public function __construct(private mixed $value) {} public function getOrCall($callable) { return $this->value; } public function map($callable) { return new Some($callable($this->value)); } public function filter($callable) { return $callable($this->value) ? $this : None::create(); } } class None extends Option { public static function create() { return new self(); } public function getOrCall($callable) { return $callable(); } public function map($callable) { return $this; } public function filter($callable) { return $this; } }');
+}
+
+if (!class_exists('Dotenv\\Repository\\RepositoryBuilder', false)) {
+    eval('namespace Dotenv\\Repository; class RepositoryBuilder { public static function createWithDefaultAdapters() { return new self(); } public function addAdapter($adapter) { return $this; } public function immutable() { return $this; } public function make() { return new class { public function get($key) { $value = $_ENV[$key] ?? $_SERVER[$key] ?? getenv($key); return $value === false ? null : $value; } public function has($key) { return $this->get($key) !== null; } }; } }');
+}
+
+class FleetOpsInternalQuoteBridgeQuoteFake extends ServiceQuote
+{
+    protected $guarded = [];
+    public $exists     = true;
+}
+
+function fleetopsInternalQuoteVendorBoot(): 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']);
+    app()->instance('redis', new class {
+        public function __call($method, $arguments)
+        {
+            return null;
+        }
+
+        public function connection($name = null)
+        {
+            return $this;
+        }
+    });
+    app()->instance('responsecache', new class {
+        public function __call($method, $arguments)
+        {
+            return null;
+        }
+    });
+    config()->set('activitylog.enabled', false);
+    config()->set('activitylog.default_auth_driver', 'web');
+    app()->bind(Illuminate\Contracts\Config\Repository::class, fn () => config());
+    $connection->table('integrated_vendors')->insert(['uuid' => 'iv-int-quote-1', 'public_id' => 'integrated_vendor_intquote1', 'company_uuid' => 'company-1', 'provider' => 'lalamove', 'credentials' => json_encode([]), 'options' => json_encode([]), 'sandbox' => '1']);
+    $connection->table('payloads')->insert(['uuid' => 'payload-int-quote-1', 'public_id' => 'payload_intquote1', 'company_uuid' => 'company-1']);
+    $connection->table('places')->insert([
+        ['uuid' => 'place-int-pickup', 'public_id' => 'place_intpickup1', 'company_uuid' => 'company-1', 'name' => 'Pickup'],
+        ['uuid' => 'place-int-dropoff', 'public_id' => 'place_intdropoff1', 'company_uuid' => 'company-1', 'name' => 'Dropoff'],
+    ]);
+    $connection->table('service_quotes')->insert(['uuid' => 'quote-int-bridge-1', 'public_id' => 'quote_intbridge1', 'company_uuid' => 'company-1', 'amount' => '4200', 'currency' => 'SGD', 'meta' => json_encode([])]);
+
+    $GLOBALS['fleetopsInternalQuoteBridgeMode'] = '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 FleetOpsInternalQuoteBridgeQuoteFake();
+                $quote->setRawAttributes(['uuid' => 'quote-int-bridge-1', 'public_id' => 'quote_intbridge1', 'company_uuid' => 'company-1', 'amount' => '4200', 'currency' => 'SGD', 'meta' => json_encode([])], true);
+
+                return $quote;
+            }
+
+            public function getQuoteFromPayload($payload, $serviceType = null, $scheduledAt = null, $isRouteOptimized = true)
+            {
+                if ($GLOBALS['fleetopsInternalQuoteBridgeMode'] === 'fail') {
+                    throw new Exception('internal vendor quote unavailable');
+                }
+
+                return $this->makeQuote();
+            }
+
+            public function getQuoteFromPreliminaryPayload($waypoints, $entities, $serviceType = null, $scheduledAt = null, $isRouteOptimized = true)
+            {
+                if ($GLOBALS['fleetopsInternalQuoteBridgeMode'] === 'fail') {
+                    throw new Exception('internal vendor preliminary quote unavailable');
+                }
+
+                return $this->makeQuote();
+            }
+
+            public function __call($method, $arguments)
+            {
+                return $this;
+            }
+        };
+    });
+
+    return $connection;
+}
+
+function fleetopsInternalQuoteVendorRequest(array $input): Request
+{
+    $request = Request::create('/int/v1/service-quotes', 'GET', $input);
+    $request->setLaravelSession(app('session.store'));
+
+    return $request;
+}
+
+test('internal payload vendor quotes return single and collection responses', function () {
+    fleetopsInternalQuoteVendorBoot();
+    $controller = new ServiceQuoteController();
+
+    $single = $controller->queryRecord(fleetopsInternalQuoteVendorRequest([
+        'payload'     => 'payload_intquote1',
+        'facilitator' => 'integrated_vendor_intquote1',
+        'single'      => '1',
+    ]));
+    expect($single)->toBeInstanceOf(JsonResponse::class)
+        ->and($single->getStatusCode())->toBe(200);
+
+    $collection = $controller->queryRecord(fleetopsInternalQuoteVendorRequest([
+        'payload'     => 'payload_intquote1',
+        'facilitator' => 'integrated_vendor_intquote1',
+    ]));
+    expect($collection)->toBeInstanceOf(JsonResponse::class)
+        ->and(json_encode($collection->getData(true)))->toContain('quote_intbridge1');
+});
+
+test('internal payload vendor bridge failures return 400 error responses', function () {
+    fleetopsInternalQuoteVendorBoot();
+    $GLOBALS['fleetopsInternalQuoteBridgeMode'] = 'fail';
+
+    $response = (new ServiceQuoteController())->queryRecord(fleetopsInternalQuoteVendorRequest([
+        'payload'     => 'payload_intquote1',
+        'facilitator' => 'integrated_vendor_intquote1',
+    ]));
+    $GLOBALS['fleetopsInternalQuoteBridgeMode'] = 'ok';
+
+    expect($response)->toBeInstanceOf(JsonResponse::class)
+        ->and($response->getStatusCode())->toBe(400)
+        ->and(json_encode($response->getData(true)))->toContain('internal vendor quote unavailable');
+});
+
+test('internal preliminary vendor quotes persist query metadata', function () {
+    $connection = fleetopsInternalQuoteVendorBoot();
+    $controller = new ServiceQuoteController();
+
+    $single = $controller->queryRecord(fleetopsInternalQuoteVendorRequest([
+        'pickup'      => 'place_intpickup1',
+        'dropoff'     => 'place_intdropoff1',
+        'facilitator' => 'integrated_vendor_intquote1',
+        'single'      => '1',
+    ]));
+    expect($single)->toBeInstanceOf(JsonResponse::class)
+        ->and((string) $connection->table('service_quotes')->where('uuid', 'quote-int-bridge-1')->value('meta'))->toContain('preliminary_query');
+
+    $collection = $controller->queryRecord(fleetopsInternalQuoteVendorRequest([
+        'pickup'      => 'place_intpickup1',
+        'dropoff'     => 'place_intdropoff1',
+        'facilitator' => 'integrated_vendor_intquote1',
+    ]));
+    expect($collection)->toBeInstanceOf(JsonResponse::class)
+        ->and(json_encode($collection->getData(true)))->toContain('quote_intbridge1');
+});
+
+test('internal preliminary vendor bridge failures return 400 error responses', function () {
+    fleetopsInternalQuoteVendorBoot();
+    $GLOBALS['fleetopsInternalQuoteBridgeMode'] = 'fail';
+
+    $response = (new ServiceQuoteController())->queryRecord(fleetopsInternalQuoteVendorRequest([
+        'pickup'      => 'place_intpickup1',
+        'dropoff'     => 'place_intdropoff1',
+        'facilitator' => 'integrated_vendor_intquote1',
+    ]));
+    $GLOBALS['fleetopsInternalQuoteBridgeMode'] = 'ok';
+
+    expect($response)->toBeInstanceOf(JsonResponse::class)
+        ->and($response->getStatusCode())->toBe(400)
+        ->and(json_encode($response->getData(true)))->toContain('internal vendor preliminary quote unavailable');
+});