@fleetbase/fleetops-engine 0.6.58 → 0.6.60

package/server/tests/Unit/Integrations/Lalamove/LalamoveQuoteAndServiceOrderTest.php

@@ -0,0 +1,381 @@
+<?php
+
+if (!function_exists('Fleetbase\Traits\config')) {
+    eval('namespace Fleetbase\Traits; function config($key = null, $default = null) { return $key === "api.cache.enabled" ? false : $default; }');
+}
+
+if (!function_exists('Fleetbase\Models\config')) {
+    eval('namespace Fleetbase\Models; function config($key = null, $default = null) { return $key === "fleetbase.connection.db" ? "mysql" : $default; }');
+}
+
+if (!function_exists('Fleetbase\FleetOps\Integrations\Lalamove\session')) {
+    eval('namespace Fleetbase\FleetOps\Integrations\Lalamove; function session($key = null, $default = null) { return $key === "company" ? "company-1" : $default; }');
+}
+
+if (!function_exists('Fleetbase\Observers\event')) {
+    eval('namespace Fleetbase\Observers; function event($event = null, $payload = []) { $GLOBALS["fleetopsLalamoveQuoteEvents"][] = $event; return []; }');
+}
+
+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\Integrations\Lalamove\Lalamove;
+use Fleetbase\FleetOps\Models\Payload;
+use Fleetbase\FleetOps\Models\Place;
+use Fleetbase\FleetOps\Models\ServiceQuote;
+use Fleetbase\LaravelMysqlSpatial\Types\Point;
+use GuzzleHttp\Client;
+use GuzzleHttp\Handler\MockHandler;
+use GuzzleHttp\HandlerStack;
+use GuzzleHttp\Middleware;
+use GuzzleHttp\Psr7\Response;
+use Illuminate\Database\ConnectionResolver;
+use Illuminate\Database\Eloquent\Model as EloquentModel;
+use Illuminate\Database\SQLiteConnection;
+use Illuminate\Http\Request;
+use Illuminate\Support\Str;
+
+/**
+ * Covers Lalamove quote creation from payloads and preliminary stops with a
+ * mocked HTTP client, and the full createOrderFromServiceQuote flow
+ * resolving senders, recipients, markets and metadata from service-quote
+ * meta and request payload references.
+ */
+if (!Str::hasMacro('humanize')) {
+    Str::macro('humanize', fn ($value) => ucfirst(str_replace(['_', '-'], ' ', Str::snake((string) $value))));
+}
+
+if (!Request::hasMacro('or')) {
+    Request::macro('or', function (array $params = [], $default = null) {
+        foreach ($params as $param) {
+            if ($this->has($param)) {
+                return $this->input($param);
+            }
+        }
+
+        return $default;
+    });
+}
+
+function fleetopsLalamoveQuoteClient(array $responses, array &$history = []): Lalamove
+{
+    $mock    = new MockHandler($responses);
+    $history = [];
+    $stack   = HandlerStack::create($mock);
+    $stack->push(Middleware::history($history));
+    $client = new Client([
+        'base_uri' => 'https://rest.sandbox.lalamove.com/v3/',
+        'handler'  => $stack,
+    ]);
+
+    $lalamove = new Lalamove('api-key', 'api-secret', true, 'SG');
+    $property = new ReflectionProperty($lalamove, 'client');
+    $property->setAccessible(true);
+    $property->setValue($lalamove, $client);
+
+    return $lalamove;
+}
+
+function fleetopsLalamoveQuoteBoot(): SQLiteConnection
+{
+    $connection = new SQLiteConnection(new PDO('sqlite::memory:'));
+    $resolver   = new ConnectionResolver(['default' => $connection, 'mysql' => $connection]);
+    $resolver->setDefaultConnection('mysql');
+    EloquentModel::setConnectionResolver($resolver);
+    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');
+
+    app()->instance('redis', new class {
+        public function get($key)
+        {
+            return null;
+        }
+
+        public function set($key, $value)
+        {
+            return true;
+        }
+
+        public function connection($name = null)
+        {
+            return $this;
+        }
+
+        public function __call($method, $arguments)
+        {
+            return null;
+        }
+    });
+    Illuminate\Support\Facades\Redis::clearResolvedInstance('redis');
+
+    app()->instance('responsecache', new class {
+        public function __call($method, $arguments)
+        {
+            return null;
+        }
+    });
+
+    $schema = $connection->getSchemaBuilder();
+    foreach (['places' => ['uuid', 'public_id', 'company_uuid', 'name', 'street1', 'city', 'country', 'phone', 'location', 'meta', 'type'], 'companies' => ['uuid', 'public_id', 'name', 'phone', 'country'], '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']] 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();
+        });
+    }
+    $connection->table('companies')->insert(['uuid' => 'company-1', 'public_id' => 'company_lala1', 'name' => 'Acme Logistics', 'phone' => '+6512345678', 'country' => 'SG']);
+
+    session(['company' => 'company-1']);
+
+    return $connection;
+}
+
+function fleetopsLalamoveQuotePlace(string $uuid, string $name): Place
+{
+    $place = new Place();
+    $place->setRawAttributes([
+        'uuid'    => $uuid,
+        'name'    => $name,
+        'street1' => $name . ' Street',
+        'country' => 'SG',
+        'phone'   => '+6591234567',
+    ], true);
+    $place->setAttribute('location', new Point(1.30, 103.80));
+
+    return $place;
+}
+
+function fleetopsLalamoveQuotationBody(): array
+{
+    return [
+        'data' => [
+            'quotationId'    => 'quote-1',
+            'scheduleAt'     => '2026-08-01T09:00:00Z',
+            'expiresAt'      => '2026-08-01T10:00:00Z',
+            'priceBreakdown' => [
+                'currency' => 'SGD',
+                'total'    => '18.50',
+                'base'     => '15.00',
+                'vat'      => '1.50',
+            ],
+            'stops' => [
+                ['stopId' => 'stop-0'],
+                ['stopId' => 'stop-1'],
+            ],
+        ],
+    ];
+}
+
+test('preliminary and payload quotes resolve markets and build service quotes', function () {
+    fleetopsLalamoveQuoteBoot();
+
+    $pickup  = fleetopsLalamoveQuotePlace('11111111-1111-4111-8111-111111111111', 'Depot');
+    $dropoff = fleetopsLalamoveQuotePlace('22222222-2222-4222-8222-222222222222', 'Customer');
+
+    $history  = [];
+    $lalamove = fleetopsLalamoveQuoteClient([
+        new Response(200, [], json_encode(fleetopsLalamoveQuotationBody())),
+        new Response(200, [], json_encode(fleetopsLalamoveQuotationBody())),
+    ], $history);
+    $lalamove->setRequestId('req-1');
+
+    $preliminary = $lalamove->getQuoteFromPreliminaryPayload([$pickup, $dropoff], [], null, null);
+    expect($preliminary)->toBeInstanceOf(ServiceQuote::class)
+        ->and($preliminary->currency)->toBe('SGD')
+        ->and((int) $preliminary->amount)->toBe(1850)
+        ->and($preliminary->items)->toHaveCount(2);
+
+    $payload = new Payload();
+    $payload->setRawAttributes(['uuid' => 'payload-1'], true);
+    $payload->setRelation('pickup', $pickup);
+    $payload->setRelation('dropoff', $dropoff);
+    $payload->setRelation('waypoints', collect());
+    $payload->setRelation('entities', collect());
+
+    $fromPayload = $lalamove->getQuoteFromPayload($payload, 'MOTORCYCLE');
+    expect($fromPayload)->toBeInstanceOf(ServiceQuote::class)
+        ->and($fromPayload->payload_uuid)->toBe('payload-1');
+});
+
+test('create order from service quote resolves senders recipients and metadata', function () {
+    $connection = fleetopsLalamoveQuoteBoot();
+    $connection->table('places')->insert([
+        ['uuid' => '11111111-1111-4111-8111-111111111111', 'public_id' => 'place_lalasq1', 'company_uuid' => 'company-1', 'name' => 'Depot', 'street1' => 'Depot Street', 'country' => 'SG', 'phone' => '+6591234567'],
+        ['uuid' => '22222222-2222-4222-8222-222222222222', 'public_id' => 'place_lalasq2', 'company_uuid' => 'company-1', 'name' => 'Customer Stop', 'street1' => 'Customer Street', 'country' => 'SG', 'phone' => '+6598765432'],
+    ]);
+
+    $company = new Fleetbase\Models\Company();
+    $company->setRawAttributes(['uuid' => 'company-1', 'public_id' => 'company_lala1', 'name' => 'Acme Logistics', 'phone' => '+6512345678', 'country' => 'SG'], true);
+
+    $serviceQuote = new ServiceQuote();
+    $serviceQuote->setRawAttributes([
+        'uuid'      => 'sq-1',
+        'public_id' => 'service_quote_lala1',
+        'currency'  => 'SGD',
+        'meta'      => json_encode([
+            'provider' => 'lalamove',
+            'data'     => [
+                'quotationId' => 'quote-1',
+                'stops'       => [['stopId' => 'stop-0'], ['stopId' => 'stop-1']],
+            ],
+        ]),
+    ], true);
+    $serviceQuote->setRelation('company', $company);
+    $serviceQuote->setRelation('integratedVendor', null);
+    $serviceQuote->setRelation('payload', null);
+
+    $request = Request::create('/v1/orders', 'POST', [
+        'pickup'    => ['uuid' => '11111111-1111-4111-8111-111111111111'],
+        'dropoff'   => ['uuid' => '22222222-2222-4222-8222-222222222222'],
+        'waypoints' => [],
+        'order'     => ['pod_required' => true],
+    ]);
+
+    $history  = [];
+    $lalamove = fleetopsLalamoveQuoteClient([
+        new Response(200, [], json_encode(['data' => ['orderId' => 'lala-order-1']])),
+    ], $history);
+
+    $result = $lalamove->createOrderFromServiceQuote($serviceQuote, $request);
+    expect($result->orderId)->toBe('lala-order-1');
+
+    $sent = json_decode((string) $history[0]['request']->getBody(), true);
+    expect($sent['data']['quotationId'])->toBe('quote-1')
+        ->and($sent['data']['sender']['stopId'])->toBe('stop-0')
+        ->and($sent['data']['recipients'])->toHaveCount(1)
+        ->and($sent['data']['isPODEnabled'])->toBeTrue()
+        ->and($sent['data']['metadata']['company'])->toBe('company_lala1')
+        ->and($sent['data']['metadata']['service_quote'])->toBe('service_quote_lala1');
+});
+
+test('quotation errors raise lalamove exceptions', function () {
+    fleetopsLalamoveQuoteBoot();
+
+    $pickup  = fleetopsLalamoveQuotePlace('11111111-1111-4111-8111-111111111111', 'Depot');
+    $dropoff = fleetopsLalamoveQuotePlace('22222222-2222-4222-8222-222222222222', 'Customer');
+
+    $history  = [];
+    $lalamove = fleetopsLalamoveQuoteClient([
+        new Response(200, [], json_encode(['errors' => [['id' => 'ERR_INVALID', 'message' => 'invalid stops']]])),
+    ], $history);
+    $lalamove->setRequestId('req-err');
+
+    expect(fn () => $lalamove->getQuoteFromPreliminaryPayload([$pickup, $dropoff], [], null, null))
+        ->toThrow(Exception::class);
+
+    $payload = new Payload();
+    $payload->setRawAttributes(['uuid' => 'payload-err'], true);
+    $payload->setRelation('pickup', $pickup);
+    $payload->setRelation('dropoff', $dropoff);
+    $payload->setRelation('waypoints', collect());
+    $payload->setRelation('entities', collect());
+
+    $lalamoveErr2 = fleetopsLalamoveQuoteClient([
+        new Response(200, [], json_encode(['errors' => [['id' => 'ERR_INVALID', 'message' => 'invalid stops']]])),
+    ], $history);
+    $lalamoveErr2->setRequestId('req-err2');
+    expect(fn () => $lalamoveErr2->getQuoteFromPayload($payload, 'MOTORCYCLE'))->toThrow(Exception::class);
+});
+
+test('create order route variables resolve from metas and payloads', function () {
+    $connection = fleetopsLalamoveQuoteBoot();
+    $connection->table('places')->insert([
+        ['uuid' => '11111111-1111-4111-8111-111111111111', 'public_id' => 'place_lalameta1', 'company_uuid' => 'company-1', 'name' => 'Depot', 'street1' => 'Depot Street', 'country' => 'SG', 'phone' => '+6591234567'],
+        ['uuid' => '22222222-2222-4222-8222-222222222222', 'public_id' => 'place_lalameta2', 'company_uuid' => 'company-1', 'name' => 'Customer Stop', 'street1' => 'Customer Street', 'country' => 'SG', 'phone' => '+6598765432'],
+    ]);
+
+    $company = new Fleetbase\Models\Company();
+    $company->setRawAttributes(['uuid' => 'company-1', 'public_id' => 'company_lalameta', 'name' => 'Acme Logistics', 'phone' => '+6512345678', 'country' => 'SG'], true);
+
+    $makeQuote = function (array $meta) use ($company) {
+        $serviceQuote = new ServiceQuote();
+        $serviceQuote->setRawAttributes([
+            'uuid'      => 'sq-meta',
+            'public_id' => 'service_quote_lalameta',
+            'currency'  => 'SGD',
+            'meta'      => json_encode(array_merge([
+                'provider' => 'lalamove',
+                'data'     => [
+                    'quotationId' => 'quote-meta',
+                    'stops'       => [['stopId' => 'stop-0'], ['stopId' => 'stop-1']],
+                ],
+            ], $meta)),
+        ], true);
+        $serviceQuote->setRelation('company', $company);
+        $serviceQuote->setRelation('integratedVendor', null);
+        $serviceQuote->setRelation('payload', null);
+
+        return $serviceQuote;
+    };
+    $request = Request::create('/v1/orders', 'POST', []);
+
+    // Preliminary data meta supplies pickup, dropoff and waypoints
+    $history  = [];
+    $lalamove = fleetopsLalamoveQuoteClient([new Response(200, [], json_encode(['data' => ['orderId' => 'meta-order-1']]))], $history);
+    $result   = $lalamove->createOrderFromServiceQuote($makeQuote(['preliminary_data' => [
+        'pickup'    => ['uuid' => '11111111-1111-4111-8111-111111111111'],
+        'dropoff'   => ['uuid' => '22222222-2222-4222-8222-222222222222'],
+        'waypoints' => [],
+    ]]), $request);
+    expect($result->orderId)->toBe('meta-order-1');
+
+    // Origin arrays become waypoints while scalar origins become the pickup
+    $history2  = [];
+    $lalamove2 = fleetopsLalamoveQuoteClient([new Response(200, [], json_encode(['data' => ['orderId' => 'meta-order-2']]))], $history2);
+    $result2   = $lalamove2->createOrderFromServiceQuote($makeQuote([
+        'origin'      => '11111111-1111-4111-8111-111111111111',
+        'destination' => '22222222-2222-4222-8222-222222222222',
+    ]), $request);
+    expect($result2->orderId)->toBe('meta-order-2');
+
+    // A network-cart origin arrives as an array of store locations, which become
+    // the waypoints; entries wrapping their place resolve through the place key
+    $history4  = [];
+    $lalamove4 = fleetopsLalamoveQuoteClient([new Response(200, [], json_encode(['data' => ['orderId' => 'meta-order-4']]))], $history4);
+    $result4   = $lalamove4->createOrderFromServiceQuote($makeQuote([
+        'origin' => [
+            ['place' => '11111111-1111-4111-8111-111111111111'],
+        ],
+        'destination' => '22222222-2222-4222-8222-222222222222',
+    ]), $request);
+    expect($result4->orderId)->toBe('meta-order-4');
+
+    // The store location is the only stop ahead of the destination, so it is
+    // what becomes the sender
+    $body4 = json_decode((string) $history4[0]['request']->getBody(), true);
+    expect($body4['data']['sender']['name'])->toBe('Depot')
+        ->and($body4['data']['recipients'][0]['name'])->toBe('Customer Stop');
+
+    // Payload relations override the route variables entirely
+    $payload = new Payload();
+    $payload->setRawAttributes(['uuid' => 'payload-meta'], true);
+    $payload->setRelation('pickup', Place::where('uuid', '11111111-1111-4111-8111-111111111111')->first());
+    $payload->setRelation('dropoff', Place::where('uuid', '22222222-2222-4222-8222-222222222222')->first());
+    $payload->setRelation('waypoints', collect());
+    $quoteWithPayload = $makeQuote([]);
+    $quoteWithPayload->setRelation('payload', $payload);
+
+    $history3  = [];
+    $lalamove3 = fleetopsLalamoveQuoteClient([new Response(200, [], json_encode(['data' => ['orderId' => 'meta-order-3']]))], $history3);
+    $result3   = $lalamove3->createOrderFromServiceQuote($quoteWithPayload, $request);
+    expect($result3->orderId)->toBe('meta-order-3');
+});

package/server/tests/Unit/Integrations/Lalamove/LalamoveServiceTypeTest.php

@@ -0,0 +1,51 @@
+<?php
+
+use Fleetbase\FleetOps\Integrations\Lalamove\LalamoveServiceType;
+
+/**
+ * Covers the LalamoveServiceType value object: dynamic property hydration,
+ * restriction fallbacks through __get, the instance-call `all` proxy, and
+ * the static find variants by key and callback.
+ */
+test('service type exposes properties and restriction fallbacks', function () {
+    $serviceType = new LalamoveServiceType([
+        'key'          => 'CAR',
+        'description'  => 'Car',
+        'restrictions' => ['length' => '70cm', 'width' => '50cm', 'height' => '50cm', 'weight' => '20kg'],
+    ]);
+
+    expect($serviceType->getKey())->toBe('CAR')
+        ->and($serviceType->description)->toBe('Car')
+        // Restriction keys resolve through the __get fallback
+        ->and($serviceType->weight)->toBe('20kg')
+        ->and($serviceType->LENGTH)->toBe('70cm')
+        ->and($serviceType->unknown_property)->toBeNull();
+});
+
+test('all returns hydrated service types statically and via instance calls', function () {
+    $all = LalamoveServiceType::all();
+
+    expect($all->count())->toBeGreaterThanOrEqual(4)
+        ->and($all->first())->toBeInstanceOf(LalamoveServiceType::class)
+        ->and($all->map(fn ($type) => $type->key)->all())->toContain('MOTORCYCLE', 'CAR', 'VAN');
+
+    // The instance __call proxy mirrors the static all()
+    $instance = new LalamoveServiceType(['key' => 'CAR']);
+    $viaCall  = $instance->all();
+    expect($viaCall->count())->toBe($all->count());
+
+    // Unknown instance calls return null
+    expect($instance->somethingUnknown())->toBeNull();
+});
+
+test('find locates service types by key string and callback', function () {
+    $van = LalamoveServiceType::find('van');
+    expect($van)->toBeInstanceOf(LalamoveServiceType::class)
+        ->and($van->key)->toBe('VAN');
+
+    $byCallback = LalamoveServiceType::find(fn ($type) => $type->key === 'SUV');
+    expect($byCallback->key)->toBe('SUV');
+
+    expect(LalamoveServiceType::find('hovercraft'))->toBeNull()
+        ->and(LalamoveServiceType::find(42))->toBeNull();
+});

package/server/tests/Unit/Integrations/LalamoveQuotationTest.php

@@ -0,0 +1,194 @@
+<?php
+
+use Fleetbase\FleetOps\Integrations\Lalamove\Lalamove;
+use Fleetbase\FleetOps\Integrations\Lalamove\LalamoveMarket;
+use Fleetbase\FleetOps\Models\IntegratedVendor;
+use Fleetbase\FleetOps\Models\ServiceQuote;
+use Illuminate\Database\ConnectionResolver;
+use Illuminate\Database\Eloquent\Model as EloquentModel;
+use Illuminate\Database\SQLiteConnection;
+
+/**
+ * Covers the Lalamove integration's quotation-to-service-quote construction,
+ * market resolution, constructor credential/market branches, and the static
+ * call proxying variants.
+ */
+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 fleetopsLalamoveBoot(): 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 = [
+        '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'],
+        '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']);
+
+    return $connection;
+}
+
+function fleetopsLalamoveQuotation(): stdClass
+{
+    return json_decode(json_encode([
+        'quotationId'    => 'quote-123',
+        'priceBreakdown' => [
+            'currency'     => 'SGD',
+            'total'        => '25.50',
+            'base'         => '20.00',
+            'extraMileage' => '3.50',
+            'vat'          => '2.00',
+        ],
+    ]));
+}
+
+test('service quote from quotation builds amounts items and metadata', function () {
+    fleetopsLalamoveBoot();
+
+    $quotation    = fleetopsLalamoveQuotation();
+    $serviceQuote = Lalamove::serviceQuoteFromQuotation($quotation, 'request_test');
+
+    expect($serviceQuote)->toBeInstanceOf(ServiceQuote::class)
+        ->and($serviceQuote->currency)->toBe('SGD')
+        ->and($serviceQuote->request_id)->toBe('request_test')
+        ->and($serviceQuote->items)->toHaveCount(3)
+        ->and(collect($serviceQuote->items)->pluck('code')->all())->toBe(['BASE_FEE', 'EXTRA_MILEAGE_FEE', 'VAT_FEE']);
+
+    expect(Lalamove::serviceQuoteFromQuotation(null))->toBeNull();
+
+    // Wrapped data payloads unwrap recursively
+    $wrapped = json_decode(json_encode(['data' => fleetopsLalamoveQuotation()]));
+    expect(Lalamove::serviceQuoteFromQuotation($wrapped)->currency)->toBe('SGD');
+});
+
+test('service quote from quotation records integrated vendor linkage', function () {
+    fleetopsLalamoveBoot();
+
+    $vendor = new IntegratedVendor();
+    $vendor->setRawAttributes(['uuid' => 'iv-1', 'public_id' => 'integrated_vendor_test'], true);
+
+    $serviceQuote = Lalamove::serviceQuoteFromQuotation(fleetopsLalamoveQuotation(), null, $vendor);
+
+    expect($serviceQuote->integrated_vendor_uuid)->toBe('iv-1')
+        ->and($serviceQuote->getMeta('from_integrated_vendor'))->toBe('integrated_vendor_test');
+});
+
+test('create service quote from quotation persists the quote and items', function () {
+    $connection = fleetopsLalamoveBoot();
+
+    $serviceQuote = Lalamove::createServiceQuoteFromQuotation(fleetopsLalamoveQuotation(), 'request_test');
+
+    expect($serviceQuote)->toBeInstanceOf(ServiceQuote::class)
+        ->and($connection->table('service_quotes')->count())->toBe(1)
+        ->and($connection->table('service_quote_items')->count())->toBe(3);
+});
+
+test('market and service type resolution handles keys and instances', function () {
+    fleetopsLalamoveBoot();
+
+    $market = Lalamove::getMarket('SG');
+    expect($market)->toBeInstanceOf(LalamoveMarket::class)
+        ->and(Lalamove::getMarket($market))->toBe($market)
+        ->and(Lalamove::getMarket('XX'))->toBeNull();
+});
+
+test('constructor resolves explicit credentials markets and company defaults', function () {
+    $connection = fleetopsLalamoveBoot();
+
+    $explicit = new Lalamove('key-1', 'secret-1', true, 'SG');
+    expect($explicit)->toBeInstanceOf(Lalamove::class);
+
+    // Company-session country drives the market default
+    $connection->table('companies')->insert(['uuid' => 'company-1', 'name' => 'Acme', 'country' => 'TH']);
+    $fromCompany = new Lalamove('key-1', 'secret-1');
+    expect($fromCompany)->toBeInstanceOf(Lalamove::class);
+});
+
+test('static call proxy resolves instance sandbox and unknown methods', function () {
+    fleetopsLalamoveBoot();
+
+    expect(Lalamove::instance('key-1', 'secret-1', false, 'SG'))->toBeInstanceOf(Lalamove::class);
+
+    $options = Lalamove::getOptionsFromSandbox();
+    expect($options)->toBeArray();
+
+    expect(Lalamove::completelyUnknownMethod())->toBeNull();
+});
+
+/**
+ * Captures the resolved market so the market-scoped quotation helper can be
+ * asserted without reaching the Lalamove API.
+ */
+class FleetOpsLalamoveMarketProbe extends Lalamove
+{
+    public array $quotationCalls = [];
+
+    public function getQuotations(...$params)
+    {
+        $this->quotationCalls[] = $params;
+
+        return [
+            'market'  => $this->readPrivate('market')->getCode(),
+            'sandbox' => $this->readPrivate('isSandbox'),
+            'params'  => $params,
+        ];
+    }
+
+    private function readPrivate(string $property): mixed
+    {
+        $reflection = new ReflectionProperty(Lalamove::class, $property);
+        $reflection->setAccessible(true);
+
+        return $reflection->getValue($this);
+    }
+}
+
+test('market scoped quotations pass the market through to the instance', function () {
+    fleetopsLalamoveBoot();
+
+    // The market must land in the market slot, not the sandbox flag
+    $result = FleetOpsLalamoveMarketProbe::getQuotationForMarket('TH', ['pickup' => 'A', 'dropoff' => 'B']);
+
+    expect($result['market'])->toBe('TH')
+        // the market must not leak into the sandbox flag
+        ->and($result['sandbox'])->toBeFalse()
+        ->and($result['params'])->toBe([['pickup' => 'A', 'dropoff' => 'B']]);
+});