@fleetbase/fleetops-engine 0.6.58 → 0.6.59

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

@@ -0,0 +1,32 @@
+<?php
+
+use Fleetbase\FleetOps\Http\Resources\v1\PurchaseRate;
+use Fleetbase\FleetOps\Http\Resources\v1\TrackingStatus;
+
+/**
+ * Covers the relation accessors on PurchaseRate and TrackingStatus when the
+ * wrapped resource is not an Eloquent model. Both first try to eager load the
+ * relation off the underlying model; with nothing model-like to load from, the
+ * accessor must fall through to null rather than error.
+ *
+ * Each accessor previously carried a middle branch guarded by
+ * `method_exists($this, 'loadMissing')`, which could never be true: no class in
+ * the resource hierarchy (PurchaseRate/TrackingStatus -> FleetbaseResource ->
+ * JsonResource) declares `loadMissing`, it only resolves through `__call`, which
+ * `method_exists` does not see. That branch has since been removed.
+ */
+test('relation accessors fall through to null without a loadable model', function () {
+    // A resource wrapping nothing at all has no relation to resolve
+    expect((new PurchaseRate(null))->serviceQuote())->toBeNull()
+        ->and((new TrackingStatus(null))->trackingNumber())->toBeNull();
+
+    // A plain object exposes no loadMissing, so the eager-load path is skipped
+    $plainRate            = new stdClass();
+    $plainRate->public_id = 'purchase_rate_plain';
+
+    $plainStatus            = new stdClass();
+    $plainStatus->public_id = 'tracking_status_plain';
+
+    expect((new PurchaseRate($plainRate))->serviceQuote())->toBeNull()
+        ->and((new TrackingStatus($plainStatus))->trackingNumber())->toBeNull();
+});

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

@@ -0,0 +1,55 @@
+<?php
+
+/**
+ * Covers the relation-resolution helpers shared by the v1 resources: loaded
+ * relations collapse to a public id for public API requests and resolve to a
+ * nested resource internally, while morph transformers fall back to a generic
+ * JSON resource when no dedicated resource class is registered.
+ */
+class FleetOpsResourceRelationModel extends Illuminate\Database\Eloquent\Model
+{
+    protected $table    = 'resource_relation_models';
+    protected $guarded  = [];
+    public $exists      = true;
+    public $timestamps  = false;
+}
+
+test('loaded relations collapse to public ids outside internal requests', function (string $resourceClass) {
+    $resource   = new $resourceClass(null);
+    $reflection = new ReflectionMethod($resourceClass, 'resolveLoadedRelation');
+    $reflection->setAccessible(true);
+
+    // Absent relations resolve to nothing
+    expect($reflection->invoke($resource, null))->toBeNull();
+
+    // Public API requests expose the related record by its public id
+    $related = new FleetOpsResourceRelationModel(['uuid' => 'related-1', 'public_id' => 'related_public1']);
+    expect($reflection->invoke($resource, $related))->toBe('related_public1');
+})->with([
+    'device'           => [Fleetbase\FleetOps\Http\Resources\v1\Device::class],
+    'equipment'        => [Fleetbase\FleetOps\Http\Resources\v1\Equipment::class],
+    'fuel transaction' => [Fleetbase\FleetOps\Http\Resources\v1\FuelTransaction::class],
+    'part'             => [Fleetbase\FleetOps\Http\Resources\v1\Part::class],
+    'sensor'           => [Fleetbase\FleetOps\Http\Resources\v1\Sensor::class],
+]);
+
+test('morph transformers serialize subjects without a dedicated resource', function (string $resourceClass) {
+    // JsonResource::resolve() reads the current request when serializing
+    app()->instance('request', Illuminate\Http\Request::create('/v1/resource', 'GET'));
+
+    $resource   = new $resourceClass(null);
+    $reflection = new ReflectionMethod($resourceClass, 'transformMorphResource');
+    $reflection->setAccessible(true);
+
+    // Find::httpResourceForModel() always resolves a class, falling back to
+    // FleetbaseResource, so unknown subjects still serialize
+    $subject  = new FleetOpsResourceRelationModel(['uuid' => 'subject-1', 'public_id' => 'subject_public1']);
+    $resolved = $reflection->invoke($resource, $subject);
+
+    expect($resolved)->toBeArray()
+        ->and($resolved['public_id'] ?? null)->toBe('subject_public1');
+})->with([
+    'maintenance'          => [Fleetbase\FleetOps\Http\Resources\v1\Maintenance::class],
+    'maintenance schedule' => [Fleetbase\FleetOps\Http\Resources\v1\MaintenanceSchedule::class],
+    'work order'           => [Fleetbase\FleetOps\Http\Resources\v1\WorkOrder::class],
+]);

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

@@ -0,0 +1,174 @@
+<?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\FleetOps\Support\config')) {
+    eval('namespace Fleetbase\FleetOps\Support; function config($key = null, $default = null) { return $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\Support\app')) {
+    eval('namespace Fleetbase\Support; function app() { return new class { public function environment(array $environments) { return true; } }; }');
+}
+
+if (!function_exists('Fleetbase\Support\config')) {
+    eval('namespace Fleetbase\Support; function config($key = null, $default = null) { return match ($key) { "fleetbase.console.host" => "console.test", "fleetbase.console.subdomain" => null, "fleetbase.console.secure" => false, default => $default }; }');
+}
+
+use Fleetbase\FleetOps\Http\Resources\v1\TrackingNumber as TrackingNumberResource;
+use Fleetbase\FleetOps\Models\TrackingNumber;
+use Illuminate\Database\ConnectionResolver;
+use Illuminate\Database\Eloquent\Model as EloquentModel;
+use Illuminate\Database\SQLiteConnection;
+use Illuminate\Http\Request;
+
+class FleetOpsTrackingNumberResourceRequestState
+{
+    public static ?Request $request = null;
+}
+
+if (!class_exists('FleetOpsSupportRequestState')) {
+    class FleetOpsSupportRequestState
+    {
+        public static ?Request $request = null;
+    }
+}
+
+if (!function_exists('request')) {
+    function request($key = null, $default = null)
+    {
+        return FleetOpsTrackingNumberResourceRequestState::$request;
+    }
+}
+
+if (!function_exists('Fleetbase\Support\request')) {
+    eval('namespace Fleetbase\Support; function request($key = null, $default = null) { return \FleetOpsSupportRequestState::$request; }');
+}
+
+class FleetOpsTrackingNumberResourceRouteFixture
+{
+    public function __construct(private string $uri)
+    {
+    }
+
+    public function uri(): string
+    {
+        return $this->uri;
+    }
+}
+
+class FleetOpsTrackingNumberResourceModelFake extends TrackingNumber
+{
+    public function getLastStatusAttribute(): string
+    {
+        return 'In Transit';
+    }
+
+    public function getLastStatusCodeAttribute(): string
+    {
+        return 'in_transit';
+    }
+}
+
+function fleetopsTrackingNumberResourceRequest(bool $internal): Request
+{
+    fleetopsTrackingNumberResourceUseConnection();
+
+    $uri     = $internal ? 'api/int/v1/fleet-ops/tracking-numbers/trk_public' : 'api/v1/fleet-ops/tracking-numbers/trk_public';
+    $request = Request::create('/' . $uri, 'GET');
+    $request->setRouteResolver(fn () => new FleetOpsTrackingNumberResourceRouteFixture($uri));
+    FleetOpsTrackingNumberResourceRequestState::$request = $request;
+    FleetOpsSupportRequestState::$request                = $request;
+
+    if (function_exists('app')) {
+        app()->instance('request', $request);
+    }
+
+    return $request;
+}
+
+function fleetopsTrackingNumberResourceUseConnection(): void
+{
+    $connection = new SQLiteConnection(new PDO('sqlite::memory:'));
+    $resolver   = new ConnectionResolver([
+        'default' => $connection,
+        'mysql'   => $connection,
+    ]);
+
+    $resolver->setDefaultConnection('mysql');
+    EloquentModel::setConnectionResolver($resolver);
+}
+
+function fleetopsTrackingNumberResourceFixture(): TrackingNumber
+{
+    $trackingNumber = new FleetOpsTrackingNumberResourceModelFake();
+    $trackingNumber->setRawAttributes([
+        'id'              => 42,
+        'uuid'            => 'tracking-uuid',
+        'public_id'       => 'trk_public',
+        'status_uuid'     => 'status-uuid',
+        'owner_uuid'      => 'order-uuid',
+        'owner_type'      => 'Fleetbase\\FleetOps\\Models\\Order',
+        'tracking_number' => 'TN-RESOURCE',
+        'region'          => 'sg',
+        'qr_code'         => 'qr-data',
+        'barcode'         => 'barcode-data',
+        'created_at'      => '2026-07-27 08:00:00',
+        'updated_at'      => '2026-07-27 09:00:00',
+    ], true);
+    $trackingNumber->setRelation('owner', (object) ['public_id' => 'order_public']);
+
+    return $trackingNumber;
+}
+
+test('tracking number resource serializes public tracking fields', function () {
+    $request = fleetopsTrackingNumberResourceRequest(false);
+    $payload = (new TrackingNumberResource(fleetopsTrackingNumberResourceFixture()))->resolve($request);
+
+    expect($payload)->toMatchArray([
+        'id'              => 'trk_public',
+        'tracking_number' => 'TN-RESOURCE',
+        'subject'         => 'order_public',
+        'region'          => 'sg',
+        'status'          => 'In Transit',
+        'status_code'     => 'in_transit',
+        'qr_code'         => 'qr-data',
+        'barcode'         => 'barcode-data',
+        'type'            => 'order',
+    ])
+        ->and($payload)->not->toHaveKeys(['uuid', 'public_id', 'status_uuid', 'owner_uuid', 'owner_type'])
+        ->and($payload['url'])->toContain('TN-RESOURCE');
+});
+
+test('tracking number resource includes internal identifiers for internal requests', function () {
+    $request = fleetopsTrackingNumberResourceRequest(true);
+    $payload = (new TrackingNumberResource(fleetopsTrackingNumberResourceFixture()))->resolve($request);
+
+    expect($payload)->toMatchArray([
+        'id'          => 42,
+        'uuid'        => 'tracking-uuid',
+        'public_id'   => 'trk_public',
+        'status_uuid' => 'status-uuid',
+        'owner_uuid'  => 'order-uuid',
+        'owner_type'  => 'fleet-ops:order',
+    ]);
+});
+
+test('tracking number resource serializes webhook payload fields', function () {
+    $payload = (new TrackingNumberResource(fleetopsTrackingNumberResourceFixture()))->toWebhookPayload();
+
+    expect($payload)->toMatchArray([
+        'id'              => 'trk_public',
+        'tracking_number' => 'TN-RESOURCE',
+        'subject'         => 'order_public',
+        'region'          => 'sg',
+        'qr_code'         => 'qr-data',
+        'barcode'         => 'barcode-data',
+        'type'            => 'order',
+    ]);
+});

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

@@ -0,0 +1,295 @@
+<?php
+
+if (!function_exists('Fleetbase\Traits\config')) {
+    eval('namespace Fleetbase\Traits; function config($key = null, $default = null) { return $key === "api.cache.enabled" ? false : $default; }');
+}
+
+use Fleetbase\FleetOps\Http\Resources\v1\Waypoint as WaypointResource;
+use Fleetbase\FleetOps\Models\Contact;
+use Fleetbase\FleetOps\Models\Place;
+use Fleetbase\FleetOps\Models\Waypoint as WaypointModel;
+use Fleetbase\LaravelMysqlSpatial\Types\Point;
+use Illuminate\Database\ConnectionResolver;
+use Illuminate\Database\Eloquent\Model as EloquentModel;
+use Illuminate\Database\SQLiteConnection;
+use Illuminate\Http\Request;
+
+class FleetOpsWaypointResourceRouteFixture
+{
+    public function __construct(private string $uri)
+    {
+    }
+
+    public function uri(): string
+    {
+        return $this->uri;
+    }
+}
+
+class FleetOpsWaypointResourceDatabaseProbe
+{
+    public function __construct(private SQLiteConnection $connection)
+    {
+    }
+
+    public function connection(): SQLiteConnection
+    {
+        return $this->connection;
+    }
+}
+
+function fleetopsWaypointResourceRequest(bool $internal): Request
+{
+    $uri     = $internal ? 'api/int/v1/fleet-ops/waypoints/place_public' : 'api/v1/fleet-ops/waypoints/place_public';
+    $request = Request::create('/' . $uri, 'GET');
+    $request->setRouteResolver(fn () => new FleetOpsWaypointResourceRouteFixture($uri));
+    app()->instance('request', $request);
+    app()->instance('redis', new class {
+        public function connection(): self
+        {
+            return $this;
+        }
+
+        public function __call(string $method, array $arguments): mixed
+        {
+            return null;
+        }
+    });
+
+    return $request;
+}
+
+function fleetopsWaypointResourceUseInMemoryConnection(): SQLiteConnection
+{
+    $connection = new SQLiteConnection(new PDO('sqlite::memory:'));
+    $connection->statement('create table waypoints (id integer primary key autoincrement, uuid varchar(64), public_id varchar(64), payload_uuid varchar(64), place_uuid varchar(64), tracking_number_uuid varchar(64), customer_uuid varchar(64) null, customer_type varchar(255) null, "order" integer null, type varchar(64) null, notes text null, pod_method varchar(64) null, pod_required integer null, time_window_start datetime null, time_window_end datetime null, service_time integer null, created_at datetime null, updated_at datetime null, deleted_at datetime null)');
+    $connection->statement('create table tracking_numbers (id integer primary key autoincrement, uuid varchar(64), tracking_number varchar(64), last_status varchar(64) null, last_status_code varchar(64) null, last_status_complete integer null, created_at datetime null, updated_at datetime null, deleted_at datetime null)');
+    $connection->statement('create table tracking_statuses (id integer primary key autoincrement, uuid varchar(64), tracking_number_uuid varchar(64), status varchar(64), code varchar(64), complete integer, created_at datetime null, updated_at datetime null, deleted_at datetime null)');
+
+    $resolver = new ConnectionResolver([
+        'default' => $connection,
+        'mysql'   => $connection,
+    ]);
+    $resolver->setDefaultConnection('mysql');
+    EloquentModel::setConnectionResolver($resolver);
+    app()->instance('db', new FleetOpsWaypointResourceDatabaseProbe($connection));
+
+    return $connection;
+}
+
+function fleetopsWaypointResourcePlace(array $attributes = []): Place
+{
+    $place = new Place();
+    $place->setRawAttributes(array_merge([
+        'id'                   => 42,
+        'uuid'                 => 'place-uuid',
+        'public_id'            => 'place_public',
+        'payload_uuid'         => 'payload-uuid',
+        'name'                 => 'Waypoint Place',
+        'location'             => new Point(1.29027, 103.851959),
+        'address'              => 'WAYPOINT PLACE - 12 ROUTE WAY, DOCK 2, SINGAPORE, CENTRAL, 018956',
+        'address_html'         => '<strong>12 Route Way</strong>',
+        'street1'              => '12 Route Way',
+        'street2'              => 'Dock 2',
+        'city'                 => 'Singapore',
+        'province'             => 'Central',
+        'postal_code'          => '018956',
+        'neighborhood'         => 'Downtown',
+        'district'             => 'District 1',
+        'building'             => 'Tower',
+        'security_access_code' => '1234',
+        'country'              => 'SG',
+        'country_name'         => 'Singapore',
+        'phone'                => '+6565550000',
+        'owner_type'           => null,
+        'owner_uuid'           => null,
+        'type'                 => 'dropoff',
+        'meta'                 => ['dock' => 'A'],
+        'eta'                  => '2026-07-27 09:30:00',
+        'created_at'           => '2026-07-26 09:00:00',
+        'updated_at'           => '2026-07-27 09:00:00',
+    ], $attributes), true);
+
+    return $place;
+}
+
+test('waypoint resource resolves public waypoint stop details from matching place and payload', function () {
+    $connection = fleetopsWaypointResourceUseInMemoryConnection();
+    $connection->table('tracking_numbers')->insert([
+        'uuid'                 => 'tracking-uuid',
+        'tracking_number'      => 'TN-WAYPOINT',
+        'last_status'          => 'Arrived',
+        'last_status_code'     => 'arrived',
+        'last_status_complete' => 1,
+        'created_at'           => '2026-07-26 08:00:00',
+        'updated_at'           => '2026-07-27 08:00:00',
+        'deleted_at'           => null,
+    ]);
+    $connection->table('tracking_statuses')->insert([
+        'uuid'                 => 'tracking-status-uuid',
+        'tracking_number_uuid' => 'tracking-uuid',
+        'status'               => 'Arrived',
+        'code'                 => 'arrived',
+        'complete'             => 1,
+        'created_at'           => '2026-07-27 08:30:00',
+        'updated_at'           => '2026-07-27 08:30:00',
+        'deleted_at'           => null,
+    ]);
+    $connection->table('waypoints')->insert([
+        'uuid'                 => 'waypoint-uuid',
+        'public_id'            => 'waypoint_public',
+        'payload_uuid'         => 'payload-uuid',
+        'place_uuid'           => 'place-uuid',
+        'tracking_number_uuid' => 'tracking-uuid',
+        'customer_uuid'        => null,
+        'customer_type'        => null,
+        'order'                => 2,
+        'type'                 => 'dropoff',
+        'notes'                => 'Use loading dock A.',
+        'pod_method'           => 'photo',
+        'pod_required'         => 1,
+        'time_window_start'    => '2026-07-27 09:00:00',
+        'time_window_end'      => '2026-07-27 10:00:00',
+        'service_time'         => 15,
+        'created_at'           => '2026-07-26 08:00:00',
+        'updated_at'           => '2026-07-27 08:00:00',
+        'deleted_at'           => null,
+    ]);
+
+    $payload = (new WaypointResource(fleetopsWaypointResourcePlace()))->resolve(fleetopsWaypointResourceRequest(false));
+
+    expect($payload)->toMatchArray([
+        'id'                   => 'place_public',
+        'order'                => 2,
+        'tracking'             => 'TN-WAYPOINT',
+        'status'               => 'Arrived',
+        'status_code'          => 'arrived',
+        'complete'             => true,
+        'name'                 => 'Waypoint Place',
+        'address'              => 'WAYPOINT PLACE - 12 ROUTE WAY, DOCK 2, SINGAPORE, CENTRAL, 018956',
+        'street1'              => '12 Route Way',
+        'street2'              => 'Dock 2',
+        'city'                 => 'Singapore',
+        'province'             => 'Central',
+        'postal_code'          => '018956',
+        'neighborhood'         => 'Downtown',
+        'district'             => 'District 1',
+        'building'             => 'Tower',
+        'security_access_code' => '1234',
+        'country'              => 'SG',
+        'phone'                => '+6565550000',
+        'type'                 => 'dropoff',
+        'meta'                 => ['dock' => 'A'],
+        'eta'                  => '2026-07-27 09:30:00',
+        'notes'                => 'Use loading dock A.',
+        'pod_method'           => 'photo',
+        'pod_required'         => true,
+        'service_time'         => 15,
+    ])
+        ->and($payload)->not->toHaveKey('uuid')
+        ->and($payload)->not->toHaveKey('public_id')
+        ->and($payload)->not->toHaveKey('waypoint_public_id')
+        ->and($payload)->not->toHaveKey('customer_uuid');
+});
+
+test('waypoint resource includes internal identifiers for internal requests', function () {
+    $connection = fleetopsWaypointResourceUseInMemoryConnection();
+    $connection->table('tracking_numbers')->insert([
+        'uuid'                 => 'tracking-uuid',
+        'tracking_number'      => 'TN-INTERNAL',
+        'last_status'          => 'Created',
+        'last_status_code'     => 'created',
+        'last_status_complete' => 0,
+        'created_at'           => '2026-07-26 08:00:00',
+        'updated_at'           => '2026-07-27 08:00:00',
+        'deleted_at'           => null,
+    ]);
+    $connection->table('tracking_statuses')->insert([
+        'uuid'                 => 'tracking-status-uuid',
+        'tracking_number_uuid' => 'tracking-uuid',
+        'status'               => 'Created',
+        'code'                 => 'created',
+        'complete'             => 0,
+        'created_at'           => '2026-07-27 08:30:00',
+        'updated_at'           => '2026-07-27 08:30:00',
+        'deleted_at'           => null,
+    ]);
+    $connection->table('waypoints')->insert([
+        'uuid'                 => 'waypoint-uuid',
+        'public_id'            => 'waypoint_public',
+        'payload_uuid'         => 'payload-uuid',
+        'place_uuid'           => 'place-uuid',
+        'tracking_number_uuid' => 'tracking-uuid',
+        'customer_uuid'        => null,
+        'customer_type'        => null,
+        'order'                => 1,
+        'type'                 => 'pickup',
+        'notes'                => null,
+        'pod_method'           => null,
+        'pod_required'         => 0,
+        'time_window_start'    => null,
+        'time_window_end'      => null,
+        'service_time'         => null,
+        'created_at'           => '2026-07-26 08:00:00',
+        'updated_at'           => '2026-07-27 08:00:00',
+        'deleted_at'           => null,
+    ]);
+
+    $payload = (new WaypointResource(fleetopsWaypointResourcePlace()))->resolve(fleetopsWaypointResourceRequest(true));
+
+    expect($payload)->toMatchArray([
+        'id'                 => 42,
+        'uuid'               => 'place-uuid',
+        'public_id'          => 'place_public',
+        'waypoint_public_id' => 'waypoint_public',
+        'tracking'           => 'TN-INTERNAL',
+        'status'             => 'Created',
+        'status_code'        => 'created',
+        'complete'           => false,
+        'address_html'       => 'WAYPOINT PLACE - 12 ROUTE WAY, DOCK 2, SINGAPORE, CENTRAL, 018956',
+        'country_name'       => 'Singapore',
+        'pod_required'       => false,
+    ])
+        ->and($payload['location'])->toBeInstanceOf(Point::class);
+});
+
+/**
+ * Covers Waypoint::setCustomerType(), which stamps the ember-facing customer type
+ * onto an already-resolved customer payload. Unlike Entity's equivalent it reads
+ * the morph class off the resolved waypoint rather than the wrapped place, so the
+ * protected `waypoint` property has to be populated for the stamp to mean anything.
+ * Both are private, hence the reflection — toArray() only reaches this branch when
+ * the waypoint carries a customer that Resolve::resourceForMorph can actually load.
+ */
+test('waypoint customer payloads are stamped with the ember resource type', function () {
+    $resource = new WaypointResource(fleetopsWaypointResourcePlace());
+
+    $waypoint = new WaypointModel();
+    $waypoint->setRawAttributes([
+        'uuid'          => 'waypoint-customer-type-1',
+        'public_id'     => 'waypoint_customertype1',
+        'customer_uuid' => 'contact-customer-type-1',
+        'customer_type' => Contact::class,
+    ], true);
+
+    $reflection = new ReflectionClass($resource);
+
+    $property = $reflection->getProperty('waypoint');
+    $property->setAccessible(true);
+    $property->setValue($resource, $waypoint);
+
+    $method = $reflection->getMethod('setCustomerType');
+    $method->setAccessible(true);
+
+    $stamped = $method->invoke($resource, ['id' => 'contact_customertype1', 'name' => 'Stamped Customer']);
+
+    expect($stamped['type'])->toBe('customer')
+        ->and($stamped['name'])->toBe('Stamped Customer')
+        ->and($stamped['customer_type'])->toBe('customer-fleet-ops:contact');
+
+    // Nothing resolved means nothing to stamp, and the input is returned as-is —
+    // this is the arm both end-to-end tests above take, since their waypoints
+    // carry no customer at all.
+    expect($method->invoke($resource, []))->toBe([])
+        ->and($method->invoke($resource, null))->toBeNull();
+});